SDK 与 MCP

一、WorkBuddy 接入（推荐）

WorkBuddy 通过远程 MCP（Streamable HTTP）连接本平台，配置完成后即可在对话中调用数据检索工具。

1. 登录 开发者控制台 · API 令牌，创建访问密钥（格式为 devnors_sk_live_…）。
2. 编辑 WorkBuddy MCP 配置文件 ~/.workbuddy/mcp.json（Windows 路径一般为 C:\Users\<用户名>\.workbuddy\mcp.json）。亦可在应用内「设置 → MCP」中编辑。
3. 按下列示例写入配置并保存，随后完全退出并重新启动 WorkBuddy，使配置生效。

{
  "mcpServers": {
    "devnors-data": {
      "type": "http",
      "url": "https://data.devnors.com/mcp",
      "headers": {
        "Authorization": "Bearer devnors_sk_live_请替换为您的密钥"
      }
    }
  }
}

配置生效后，客户端可调用下列工具：

• list_capabilities：查询可用数据域、类型、过滤字段及错误码说明
• legal_case_search：检索裁判文书
• legal_law_search：检索法律法规条文
• content_keyword_index：关键词流量指数
• 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 发起统一查询

远程 MCP 与 POST /v1/data/query 采用同一套身份认证与计费规则。本地联调可将 url 设置为 http://127.0.0.1:8080/mcp。

二、Cursor 及其他 MCP 客户端

远程 HTTP 配置格式与 WorkBuddy 一致。Cursor 通常使用配置文件 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "devnors-data": {
      "type": "http",
      "url": "https://data.devnors.com/mcp",
      "headers": {
        "Authorization": "Bearer devnors_sk_live_请替换为您的密钥"
      }
    }
  }
}

三、Python SDK

安装：pip install devnors-data。调用示例：

from devnors_data import DevnorsData

client = DevnorsData()
res = client.legal_cases("民间借贷 利息", top_k=5)
for hit in res["hits"]:
    print(hit["case_no"], hit["court_name"])

四、本机 stdio MCP（可选）

适用于私有化或离线调试场景。安装：pip install devnors-mcp。配置示例：

{
  "mcpServers": {
    "devnors-data": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "devnors_mcp.server"],
      "env": { "DEVNORS_API_KEY": "devnors_sk_live_请替换为您的密钥" }
    }
  }
}

一般调用方应优先使用远程 MCP。若在 Windows 环境下采用 stdio 方式，请将 command 指定为 Python 解释器的绝对路径，以免因 PATH 未包含可执行文件而导致连接失败。