DX MCP Server

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

.png)

About

The DX MCP Server is a Python-based tool that empowers AI applications, such as Claude for Desktop and Cursor, to interact with your DX Data Cloud database. The server includes tools to:
- establish a connection to your Postgres database, allowing the AI to actively formulate and execute queries on the database
- find/utilize context about your software entities and their relationships and scorecards via DX catalog tools

Learn more about the Model Context Protocol (MCP).

Note: DX intends for the CLI to become the primary interface for AI agents and is investing in it as the long-term direction beyond the MCP server. Both interfaces remain supported.

Demo

https://github.com/user-attachments/assets/c6ce12a5-4562-4b44-b235-2d04871c3142

Getting Started

There are two ways to use the DX MCP Server:
1. Remote hosting (recommended): Connect to our hosted server at https://ai.getdx.com/mcp
2. Local hosting: Run the server on your machine

Prerequisites

- A DX account with access to Data Cloud

- For remote hosting:
- A DX API token, generated in your DX Account Settings
- Admin users can create an organization API token with read scopes granted, and non-admin users can generate personal access tokens to authenticate with the MCP server.

- For local hosting:
- Python 3.10 or higher
- Your database connection URL (configured on DX's DB Users settings page)
- A DX API token, generated in your DX Account Settings
- Admin users can create an organization API token with read scopes granted, and non-admin users can generate personal access tokens to authenticate with the MCP server.
---

Option 1: Remote Hosting (Recommended)

The hosted MCP server uses streamable HTTP transport and is available at https://ai.getdx.com/mcp. This option requires no local installation; just configure your AI client with the mcp using http transport and provided with a valid DX API Token.

Claude Code

Run this command in your terminal:

claude mcp add --transport http dx-mcp https://ai.getdx.com/mcp --header "Authorization: Bearer [YOUR_DX_API_TOKEN]"

Cursor

Add this configuration to your MCP settings (Cursor > Settings > Cursor Settings > MCP):

{
  "mcpServers": {
    "dx-mcp": {
      "url": "https://ai.getdx.com/mcp",
      "headers": {
        "Authorization": "Bearer [YOUR_DX_API_TOKEN]"
      }
    }
  }
}

---

Option 2: Local Installation

If you prefer to run the DX MCP Server locally, you can install it via PyPI or run it from source.

Installation Method 1: Install from PyPI

Install the package using pip:

pip install dx-mcp-server

> Note for macOS users: If you encounter an "externally-managed-environment" error, use pipx instead:
>

> pipx install dx-mcp-server

> 

Installation Method 2: Clone from Source

Clone this repository to run from source:

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

Configuration

Once installed, configure your AI client with the appropriate settings:

Claude Code

Run this command in your terminal (adjust based on your installation method):

```bash