数据库查询服务器

一个基于IoTDB的模型上下文协议服务器,提供数据库交互和业务智能功能,支持SQL查询。

  • by xiangmy21
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 xiangmy21/iotdb-mcp-server-TreeModel

使用说明

树模型的IoTDB MCP服务器

概述

一种模型上下文协议(MCP)服务器实现,通过IoTDB提供数据库交互和商业智能功能。此服务器允许运行SQL查询。

组件

资源

服务器不公开任何资源。

鼓励

服务器不提供任何提示。

工具

服务器提供三个核心工具:

查询工具

  • metadata_query
    • 执行SHOW/COUNT查询以从数据库读取元数据
    • 输入:
    • query_sql (string):要执行的SHOW/COUNT SQL查询
    • 返回:查询结果为对象数组
  • select_query
    • 执行SELECT查询以从数据库中读取数据
    • 输入:
      • query_sql (string):要执行的SELECT SQL查询
    • 返回:查询结果为对象数组

Claude桌面集成

先决条件

  • Python与 uv 包管理器
  • IoTDB安装
  • MCP服务器依赖关系

发展

# Clone the repository
git clone https://github.com/apache/iotdb-mcp-server.git
cd iotdb_mcp_server

# Create virtual environment
uv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install development dependencies
uv sync

在Claude Desktop的配置文件中配置MCP服务器:

MacOS

地点: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗

地点: %APPDATA%/Claude/claude_desktop_config.json

您可能需要在命令字段中输入uv可执行文件的完整路径。你可以通过跑步来获得这个 which uv 在MacOS/Linux或 where uv 在Windows上。

{
  "mcpServers": {
    "iotdb": {
      "command": "uv",
      "args": [
        "--directory",
        "YOUR_REPO_PATH/src/iotdb_mcp_server",
        "run",
        "server.py"
      ],
      "env": {
        "IOTDB_HOST": "127.0.0.1",
        "IOTDB_PORT": "6667",
        "IOTDB_USER": "root",
        "IOTDB_PASSWORD": "root",
        "IOTDB_DATABASE": "test"
      }
    }
  }
}