Devnors Data MCP Server

一个 API Key，让 Claude / Cursor 等 AI 助手直接调用 Devnors Data 的高质量数据（法律等多领域官方权威数据，每条出处可回溯）。

安装

PyPI 正式发布进行中（打 mcp-v* tag 触发，见 docs/RELEASE.md）。发布后：

pip install devnors-mcp

发布前可用源码安装（从仓库根目录，MCP 依赖 SDK）：

pip install -e ./sdk -e ./mcp_server

在 Claude Desktop / Cursor 接入

在 MCP 配置（Claude Desktop 的 claude_desktop_config.json 或 Cursor 的 ~/.cursor/mcp.json）加入：

{
  "mcpServers": {
    "devnors-data": {
      "command": "devnors-mcp",
      "env": {
        "DEVNORS_API_KEY": "devnors_sk_live_xxx"
      }
    }
  }
}

填入 API Key 即可，其余由 Agent 自己操作：它会先用 list_capabilities 自发现能调什么、怎么调、出错怎么办，再按需检索。

API Key 在 开发者控制台 创建。

环境变量

提供的工具

计费与错误处理

按次调用计费，成功返回含 units（消耗 tokens）与 request_id。失败返回结构化错误，Agent 可据此自纠：

retryable=是 的错误（429/5xx）由底层 SDK 自动有界退避重试，MCP 层不再叠加；重试耗尽仍失败才回传上表错误。

故障排查

• 报 unauthorized：确认 DEVNORS_API_KEY 已设且未吊销；控制台可重建 Key。
• 连接超时/unavailable：确认能访问 DEVNORS_DATA_BASE_URL（默认公网 data.devnors.com）；私有化部署需显式设置该变量。
• 报障对账：把错误里的 request_id 提供给支持，可精确定位单次调用。