SDK 与 MCP

一、WorkBuddy 接入（推荐）

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

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_bidword：网站竞价词挖掘
• content_wechat_index_v2：微信指数 v2（时间序列；多词用 | 分隔；按词计费）
• enterprise_search：搜索
• enterprise_contact：企业联系方式
• enterprise_staff：主要人员
• enterprise_holder：企业股东
• enterprise_invest：对外投资
• enterprise_changeinfo：变更记录
• enterprise_kt_announcement：开庭公告
• enterprise_court_announcement：法院公告
• enterprise_court_register：立案信息
• enterprise_punishment：行政处罚
• enterprise_illegal：严重违法
• enterprise_abnormalinfo：经营异常
• enterprise_copy_reg：软件著作权
• enterprise_copy_reg_works：作品著作权
• enterprise_baseinfo_normal：企业基本信息
• enterprise_company_info：上市公司企业简介
• enterprise_stock_announcement：上市公告
• enterprise_equity_change：股本变动
• enterprise_bonus_info：分红情况
• cloud_express：快递查询
• cloud_express_com：快递公司编号对照
• cloud_web_search：联网搜索
• cloud_text_vector：文本转向量
• 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 未包含可执行文件而导致连接失败。