Skip to main content

Use natural language to write and execute queries on your organizational data in DX Data Cloud

Project description

DX MCP Server

Use natural language to write and execute queries on your organizational data in DX Data Cloud!

About

The DX MCP Server is a Python-based tool that lets you interact with your Data Cloud database through MCP clients, such as Claude for Desktop and Cursor. The server runs locally and establishes a connection to the inputted Postgres database. A query tool is exposed, allowing the AI to formulate and execute queries on the database.

Installation

You can use the DX MCP Server in two ways:

Option 1: Install from PyPI

Install directly using pip:

pip install dx-mcp-server

Option 2: Use from Source

Simply clone this repository:

git clone https://github.com/get-dx/dx-mcp-server

Set up the MCP client

Both Claude for Desktop and Cursor use JSON configuration files to set up MCP servers. The configuration process is similar for both:

1. Access the configuration file

  • Claude for Desktop: Click Claude > Settings > Developer > Edit Config
    • Config location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
  • Cursor: Click Cursor > Settings > Cursor Settings > MCP > Add new global MCP Server
    • This directly opens the JSON editor

2. Add the MCP server configuration

Add the following configuration to the JSON file, adjusting based on your installation method:

If you installed via pip:

{
  "mcpServers": {
    "DX Data": {
      "command": "dx-mcp-server",
      "env": {
        "DB_URL": "YOUR-DATABASE-URL"
      }
    }
  }
}

If you're using from source:

{
  "mcpServers": {
    "DX Data": {
      "command": "python", # MacOS users may need to instead use the path to the Python executable
      "args": ["-m", "dx_mcp_server"],
      "cwd": "/path/to/dx-mcp-server",  # Replace with the path to your cloned repository
      "env": {
        "DB_URL": "YOUR-DATABASE-URL"
      }
    }
  }
}

3. Restart and use

After saving the configuration, restart your MCP client. You should see "DX Data" in the available tools. When you use the database query tool, the client will ask for your approval before proceeding.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dx_mcp_server-0.1.0.tar.gz (12.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dx_mcp_server-0.1.0-py3-none-any.whl (4.9 kB view details)

Uploaded Python 3

File details

Details for the file dx_mcp_server-0.1.0.tar.gz.

File metadata

  • Download URL: dx_mcp_server-0.1.0.tar.gz
  • Upload date:
  • Size: 12.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for dx_mcp_server-0.1.0.tar.gz
Algorithm Hash digest
SHA256 607d27a9155c61e3d733024a6c486b5dbdbff1ee200b6ae0eda61ebc0954924d
MD5 0d6331906d05c2f65db36e6c472b4f38
BLAKE2b-256 09168a6c8f06e0701d99d96b0371e979247f125cda0a212d36ad205cd5ee7e98

See more details on using hashes here.

File details

Details for the file dx_mcp_server-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: dx_mcp_server-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 4.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for dx_mcp_server-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 25d51f36db1726ee5791df4f12032463bbe0b96db7e18165826f164d14b3e45e
MD5 1e8b429f2af4fd2347ae5eebb163abd2
BLAKE2b-256 2b77f75fb88ab1db4fa328f87524e79bb68feb73b7ee7a5eb80a88a54aa78f19

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page