在 Codex、Claude Desktop、Cursor、WorkBuddy 等 MCP 客户端中使用 Devnors Data。

Devnors Data MCP 可以帮助你的 AI 助手发现可用能力、查看所需参数，并用你的 API Key 调用法律 / 企业 / 内容 / 学术研究 / 快递等接口。

支持的客户端

只要你的 AI 客户端支持 MCP，就可以使用 Devnors Data MCP。常见客户端包括：

• Codex
• Claude Desktop
• Cursor
• WorkBuddy
• 其他支持 MCP 的 AI 助手

如果你使用 Codex，可以把 Devnors Data 添加为远程 MCP 服务，并使用下面的远程 HTTP 地址和 Authorization 请求头。

快速接入

远程 HTTP

推荐使用远程 HTTP 方式接入，无需本机安装 Python。

{
  "mcpServers": {
    "devnors-data": {
      "url": "https://data.devnors.com/mcp",
      "headers": {
        "Authorization": "Bearer devnors_sk_live_xxx"
      }
    }
  }
}

请先在 控制台 创建 API Key。

本地 stdio

也可以先 pip install devnors-mcp，再在本地运行：

{
  "mcpServers": {
    "devnors-data": {
      "command": "python",
      "args": ["-m", "devnors_mcp.server"],
      "env": {
        "DEVNORS_API_KEY": "devnors_sk_live_xxx"
      }
    }
  }
}

Windows 上客户端 PATH 经常找不到 devnors-mcp，请优先使用上面的 python -m 写法，或把 command 写成 Python 绝对路径。

Token

使用你的 Devnors Data API Key：

Authorization: Bearer devnors_sk_live_xxx

本地 stdio 也可以使用：

DEVNORS_API_KEY=devnors_sk_live_xxx

推荐使用 Bearer … 格式。

本地 stdio 可选私有化地址：

DEVNORS_DATA_BASE_URL=https://data.devnors.com

使用示例

你可以直接对 MCP 客户端说：

列出 Devnors Data 现在有哪些能力，以及各自需要什么参数。

更多示例：

帮我查民间借贷利息相关的裁判文书。

查一下合同解除相关的现行法条。

用统一社会信用代码查这家公司的工商信息。

核查这家公司是否被列入失信被执行人。

看看今天抖音热搜。

用快递公司编号和运单号查物流。

按标题搜论文 Attention Is All You Need。

搜学者 Andrew Ng，并打开第一条详情。

接口返回 insufficient_balance，接下来该怎么做？

接口返回 rate_limited，帮我安全重试。

AI 助手可以先调用 list_capabilities，说明必填参数，在你提供参数后调用对应工具， 并帮助解释常见错误码。

提供的工具

工具	说明
list_capabilities	自发现：拉取 /capabilities.json，返回可调 domain/type、filters、字段、示例、错误码
legal_case_search	检索裁判文书（官方公开，出处可回溯）
legal_law_search	检索现行法律法规条文
content_keyword_index	关键词流量指数（含 SEM）
content_suggest_list	下拉联想词挖掘（多平台）
content_keyword_word	海量长尾词挖掘
content_wechat_index_v2	微信指数 v2（时间序列；按词计费）
content_hot_rank	微博 / 抖音热搜榜
enterprise_company_detail_v2	企业工商信息
enterprise_annual_report_list	企业年报列表
enterprise_annual_report_detail	企业年报详情
enterprise_account_open	企业开户信息
enterprise_company_tag	企业标签
enterprise_same_legal_company	同法人企业
enterprise_key_person	主要人员列表
enterprise_shareholder	股东信息
enterprise_branch_org	分支机构
enterprise_industrial_commercial_change	工商变更
enterprise_taxpayer_basic	纳税人基本信息
enterprise_tax_credit_level	信用等级
enterprise_tax_illegal	违法信息
enterprise_tax_illegal_major	重大违法列表
enterprise_tax_illegal_major_detail	重大违法详情
enterprise_operation_except	经营异常信息
enterprise_admin_punishment	行政处罚信息
enterprise_judgment_list	裁判文书列表
enterprise_court_notice_list	法院公告列表
enterprise_court_trial_list	开庭公告列表
enterprise_cases_info_list	立案信息列表
enterprise_termination_case_list	终本案件信息列表
enterprise_serious_illegal	严重违法
enterprise_exec_person	被执行人
enterprise_breach_of_trust	失信被执行人
enterprise_listed_company	上市信息
enterprise_listed_company_neeq	上市信息（新三板）
cloud_express	快递物流查询
cloud_express_com	快递公司编号对照
cloud_web_search	联网搜索
cloud_invoice_ocr	发票 OCR 识别
research_paper_search	论文搜索
research_patent_search	专利搜索
research_journal_search	期刊/会议搜索
research_paper_detail	论文详情
research_patent_detail	专利详情
research_journal_detail	期刊/会议详情
research_scholar_search	学者搜索
research_scholar_detail	学者详情
data_query	统一入口：任意 domain + type + filters 查询

计费与错误

成功返回含 units 与 request_id。失败返回结构化字段，便于 Agent 自纠：

code	含义	retryable
unauthorized	Key 无效 / 缺失	否
insufficient_balance	余额不足	否
rate_limited	触发限流	是
invalid_capability	domain/type 无效	否
not_implemented	能力规划中	否
unavailable / upstream_error	服务暂不可用	是

可重试的 429 / 5xx 由底层 Python SDK 做有界退避；MCP 层不再叠加重试。