Metadata-Version: 2.4
Name: mcp-doris-xues87
Version: 0.1.0
Summary: MCP server for Apache Doris database - connect AI clients to Doris
Author: xuesong
License-Expression: MIT
Project-URL: Repository, https://github.com/xuesong/mcp-doris
Keywords: mcp,doris,apache-doris,database,mcp-server
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Database
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: pymysql>=1.1.0

# 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

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

## Usage

### Claude Desktop

Add to `claude_desktop_config.json`:

```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  |
