Home / MCP / Apache Doris MCP Server

Apache Doris MCP Server

Provides an MCP server to connect, query, and manage Apache Doris data sources via MCP clients.

python

15stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "doris": {
            "command": "uv",
            "args": [
                "run",
                "--with",
                "mcp-doris",
                "--python",
                "3.13",
                "mcp-doris"
            ],
            "env": {
                "DORIS_HOST": "<doris-host>",
                "DORIS_PORT": "<port>",
                "DORIS_USER": "<doris-user>",
                "DORIS_PASSWORD": "<doris-pwd>"
            }
        }
    }
}

You can run an MCP server for Apache Doris to expose Doris data sources and actions to MCP clients. This server enables you to connect, query, and manage Doris from your MCP workflow, using a simple command-driven bridge between Doris and MCP tooling.

How to use

You interact with the Doris MCP Server through an MCP client by starting the server with your Doris connection details and then issuing commands from the client to access Doris data sources and perform actions. The server runs in the background and surfaces endpoints you can invoke from your MCP tooling, dashboards, or automation pipelines. When the server is running, you will access its web UI at http://localhost:5173 to inspect status, configuration, and available actions.

How to install

Prerequisites you need before installing the Doris MCP Server:

uv sync
source .venv/bin/activate
export PYTHONPATH=/path/to/mcp-doris:$PYTHONPATH
env DORIS_HOST=<doris-host> DORIS_PORT=<port> DORIS_USER=<doris-user> DORIS_PASSWORD=<doris-pwd> mcp dev mcp_doris/mcp_server.py

Then open http://localhost:5173 in your web browser to access the MCP UI and configuration.

Publish and build are supported for deployment to your environment. To build the server package and publish it, run the following commands:

uv build
uv publish

Additional notes

The Doris MCP Server uses environment variables to connect to your Doris instance. You provide the host, port, user, and password when starting the server, either in a shell or via a wrapper script. The web UI on http://localhost:5173 gives you a convenient view of active connections, available actions, and runtime logs to help you troubleshoot.

Run configurations

Cursor configuration shown for running the Doris MCP Server as an MCP stdio process requires setting Doris connection details in the environment and invoking the uv runner with the Doris MCP module.

{
  "+name+": "doris",
  "+type+": "stdio",
  "+command+": "uv",
  "+args+": ["run", "--with", "mcp-doris", "--python", "3.13", "mcp-doris"],
  "+env+": [
    {"name": "DORIS_HOST", "value": "<doris-host>"},
    {"name": "DORIS_PORT", "value": "<port>"},
    {"name": "DORIS_USER", "value": "<doris-user>"},
    {"name": "DORIS_PASSWORD", "value": "<doris-pwd>"}
  ]
}

Usage example snippets

{ 
  "command": "uv",
  "args": ["run", "--with", "mcp-doris", "--python", "3.13", "mcp-doris"],
  "env": [
    {"name": "DORIS_HOST", "value": "<doris-host>"},
    {"name": "DORIS_PORT", "value": "<port>"},
    {"name": "DORIS_USER", "value": "<doris-user>"},
    {"name": "DORIS_PASSWORD", "value": "<doris-pwd>"}
  ]
}