TapDB MCP Agent

概览

TapDB 的 MCP Agent，用于列出项目并执行只读 SQL 查询。

能力

Tools

提供 2 个核心工具：

• list_projects

  • 列出当前可访问的项目
  • 输入：无
  • 返回：项目列表（包含 id、name、appid 等信息）

• list_project_tables

  • 查询指定项目的可访问数据表清单
  • 输入：
    • project_id (string): 项目的数字 ID（来自 list_projects）
  • 返回：返回结果是一个对象列表，对象包含'table_name','description'等信息

• execute_project_query

  • 对指定项目执行只读 SQL
  • 输入：
    • project_id (string): 项目的数字 ID（来自 list_projects）
    • sql (string): 只读 SQL（仅 SELECT/DESC 等）
    • result_format (string,optional): 选择'csv'或者'dict',默认是csv
    • save_file_path (string,optional): 本地保存文件路径，结果写入该文件，并返回一个空list
  • 返回：result_format=csv时返回一个list[list[str,Any]]，=dict时返回list[dict[str, Any]]

从源码构建

cd /path/to/tapdb-mcp-agent
uv pip install .
uv build

与 Cline 一起使用

# 添加到 cline_mcp_settings.json
"mcpServers": {
  "tapdb-mcp-agent": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "tapdb-mcp-agent",
      "tapdb-mcp-agent"
    ],
    "env": {
      "TAPDB_MCP_KEY": "{由TapDB分配给您的Access Key}",
      "TAPDB_MCP_ENDPOINT": "{cn=国内环境，sg=海外环境。默认是国内环境}"
    }
  }
}