Dolphindb MCP Server

1 
2 
3## 🧱 安装方式
4[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/tradercjz/dolphindb-mcp-server)](https://archestra.ai/mcp-catalog/tradercjz__dolphindb-mcp-server)
5 
6### ✅ 方法一：使用 `uvx`（推荐）
7 
8通过 `uvx` 安装并运行：
9 
10```bash
11uvx install dolphindb-mcp-server
12```
13 
14安装完成后，直接运行：
15```bash
16uvx dolphindb-mcp-server
17```
18> 📌 **注意**：`uvx` 安装方式需要通过 `uv.pack` 构建并上传到 Universe。如果你尚未上传，请参考 `uv` 文档进行打包与发布。
19 
20### ✅ 方法二：从 PyPI 安装
21 
22```bash
23pip install dolphindb-mcp-server
24```
25安装后运行：
26```bash
27dolphindb-mcp-server
28```
29 
30### ✅ 方法三：本地构建 & 安装
31 
32```bash
33git clone https://github.com/your-org/dolphindb-mcp-server.git
34cd dolphindb-mcp-server
35 
36# 创建并激活虚拟环境
37python -m venv .venv
38source .venv/bin/activate
39 
40# 构建并安装
41pip install build
42python -m build
43pip install dist/*.whl
44```
45安装后运行：
46```bash
47dolphindb-mcp-server
48```
49 
50## 🧪 测试运行
51 
52运行后你可以直接使用工具，例如：
53 
54```bash
55dolphindb-mcp-server
56```
57 
58或（如果是 `uvx` 安装）：
59 
60```bash
61uvx dolphindb-mcp-server
62```
63好的，这是转换后的 Markdown 版本：
64 
65好的，这是转换后的 Markdown 版本：
66 
67---
68 
69## 🚀 使用方法
70 
711.  **配置环境变量（可选）**
72 
73    你可以通过 `.env` 文件或系统环境变量配置 DolphinDB 的连接信息：
74 
75    ```env
76    DDB_HOST=127.0.0.1
77    DDB_PORT=8848
78    DDB_USER=admin
79    DDB_PASSWD=123456
80    ```
81 
82    也可以不设置，系统将使用默认值。
83 
842.  **启动服务**
85 
86    ```bash
87    dolphindb-mcp-server
88    ```
89 
90    该命令会启动 MCP 插件服务，供外部调用。
91 
923.  **FastMCP Agent 使用示例**
93 
94    启动后，你的工具将通过 FastMCP 对外暴露以下函数接口：
95 
96    *   `list_dbs()`
97    *   `list_tbs(dbName: str)`
98    *   `query_table_diskusage(database: str, tableName: str)`
99    *   `query_dolphindb(script: str)`
100 
101    可通过 MCP 前端界面或对接 LLM 工具链来进行访问。
102