dx

DX MCP Server provides a Python-based MCP endpoint that lets AI applications securely connect to your DX Data Cloud Postgres database and access DX catalog tooling. It enables natural language queries to be translated into SQL queries and orchestrates access to DX entity context and relationships, scoring, and catalog lookups. With this MCP server running locally, you can connect your AI client (such as Claude for Desktop or Cursor) to your DX data using the MCP transport, then issue questions like “Show me active customers last quarter” or “What are the top related entities in the catalog for the Payment service?” The server exposes tools to establish a database connection, run queries, and fetch DX catalog data to inform AI reasoning. When configuring your AI client, point it at the MCP endpoint and provide the necessary authentication token to enable catalog and entity tooling.

Prerequisites:

• Python 3.10 or higher
• Access to a DX Data Cloud Postgres URL and a DX Web API Token with read scopes
• Either install from PyPI or run from source

Installation Method 1: Install from PyPI

pip install dx-mcp-server

Note for macOS users: If you encounter an externall y-managed-environment error, you may prefer using pipx:

pipx install dx-mcp-server

Installation Method 2: Clone from Source

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

Configure and run from source using uv as described in the mcp_config example.

Tips and common considerations:

• Environment variables:
  • DB_URL is the DX Data Cloud Postgres connection string
  • WEB_API_TOKEN enables additional catalog and entity tools
• If you install via pip and run locally, ensure the dx-mcp-server executable is in your PATH or provide the full path in your MCP client config
• When using GUI clients (Claude Desktop or Cursor), you may need to provide full path to the dx-mcp-server or uv executable in the client’s MCP settings if PATH is not inherited by the GUI environment
• If you encounter connection issues, verify that DB_URL is accessible from the host and that WEB_API_TOKEN has the required scopes
• For remote hosting, you can also configure the remote MCP at the provided URL and pass the Authorization header in the client configuration