MCP 服务器

简介

代码库提供了 mcp_server.py，一个原生的 Model Context Protocol stdio 服务器。它是这个公开 API 之上的轻量前端——通过 HTTP 与运行中的服务器通信，使 AI 助手能够通过结构化的工具调用而非原始 HTTP 来探索 DSA 透明度数据。绝不暴露 SQL；每个查询都经过与 API 其余部分相同的经过验证的查询层。

工具

• list_tables
  列出 DSA 报告表和数据集所属期间。
• describe_table
  显示某个表可查询的维度和度量。
• dataset_overview
  整个数据集的关键汇总数据。
• run_query
  运行结构化查询（单表或复合）并返回 JSON 行。
• ask
  用自然语言提问；LLM 会将其转换为经过验证的结构化查询。
• register
  根据姓名和邮箱生成演示 API 密钥——解锁下方需要鉴权的工具。
• submit_query
  提交完整的异步查询作业（无行数上限、CSV 导出、复合查询）并返回作业 id。
• poll_job
  轮询已提交的作业直至完成并返回其结果。

submit_query、poll_job 和 ask 需要 API 密钥；register 会生成一个演示密钥。

连接方式

将该服务器添加到你的 MCP 主机（例如 Claude Desktop 的 claude_desktop_config.json）。完整设置见 docs/MCP.md，现成示例见仓库中的 mcp-config.example.json。

{
  "mcpServers": {
    "transparency-report-api": {
      "command": "/absolute/path/to/transparency-report-api/.venv-mcp/bin/python",
      "args": ["/absolute/path/to/transparency-report-api/mcp_server.py"],
      "env": {
        "TRANSPARENCY_API_URL": "https://your-deployment.example",
        "TRANSPARENCY_API_KEY": "momo"
      }
    }
  }
}

通过 TRANSPARENCY_API_URL、TRANSPARENCY_API_KEY 和 TRANSPARENCY_API_TIMEOUT 配置。其依赖（mcp + httpx）位于 requirements-mcp.txt，与应用镜像分开。需要密钥？获取 API 密钥 →