MCP-Doris

MCP server for Apache Doris database. Lets AI clients (Claude Desktop, Cursor, etc.) query and manage Doris databases through the Model Context Protocol.

Install

git clone <repo-url>
cd mcp-doris
pip install -e .

Usage

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "doris": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/mcp-doris",
        "python", "-m", "mcp_doris",
        "--host", "192.168.1.100",
        "--port", "9030"
      ],
      "env": {
        "DORIS_USER": "admin",
        "DORIS_PASSWORD": "your_password"
      }
    }
  }
}

You can also configure via environment variables only (no CLI args):

Variable	Default
`DORIS_HOST`	`127.0.0.1`
`DORIS_PORT`	`9030`
`DORIS_USER`	`root`
`DORIS_PASSWORD`	(empty)
`DORIS_CHARSET`	`utf8mb4`
`DORIS_DATABASE`	(none)
`DORIS_TIMEOUT`	`30`

Tools

Tool	Description
`list_databases`	List all databases
`list_tables`	List all tables in a database
`describe_table`	Show CREATE TABLE statement with Doris specifics
`execute_query`	Execute SELECT queries (default limit: 100 rows)
`execute_statement`	Execute DDL/DML (INSERT, UPDATE, DELETE, CREATE)

Resources

Resource	Description
`schema://{database}/{table}`	Table schema info

Development Status
- 4 - Beta
Intended Audience
- Developers
Programming Language
Topic
- Database

Metadata

Development Status
- 4 - Beta
Intended Audience
- Developers
Programming Language
Topic
- Database

Release files for mcp-doris-xues87 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-doris-xues87 0.2.0
File	Size	Uploaded
mcp_doris_xues87-0.2.0.tar.gz	83.8 kB	Jul 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-doris-xues87 0.2.0
File	Interpreter	ABI	Platform	Reset
mcp_doris_xues87-0.2.0-py3-none-any.whl 8.7 kB Jul 14, 2026	Python 3	none	any	Details

Total release size: 92.4 kB

Release files / mcp_doris_xues87-0.2.0.tar.gz

Download URL	mcp_doris_xues87-0.2.0.tar.gz
Size	83.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`b0988a0bae6aa49cd7ba453c1bfcdd09616245d1918f5961010e31c1e13bf470`
BLAKE2b-256 checksum How to use checksums	`de4349d8c999da3419e38feabeb7cf8de7758237fcbf28ab1cb6e3f47c4f7f71`
Upload date	Jul 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / mcp_doris_xues87-0.2.0-py3-none-any.whl

Download URL	mcp_doris_xues87-0.2.0-py3-none-any.whl
Size	8.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ac82e73e78c7827539f0ab204579a2a40230268607af4a01def719c19a7e1736`
BLAKE2b-256 checksum How to use checksums	`f34465e26eff4865303b6804883e88c434b8183e7e8961bde98b0e62e140953c`
Upload date	Jul 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`