质数幻方 MCP 使用文档

接入指南

以下为任何支持 MCP 协议的 AI 工具（如 WorkBuddy、ClaudeCode、QoderWork 等）的通用接入方式。

接入步骤如下：

获取 MCP 接入凭证

在质数幻方官方平台（https://mcp.yidian.cn/）完成账号注册并登录，进入「API KEY 服务」生成新密钥，在「一键使用」区域获取全套 MCP 配置内容（带上你的 API Key），可直接复制使用。

配置 MCP 服务

在智能体客户端找到「添加 MCP 服务 / MCP 配置」入口，粘贴上面复制的 JSON，保存并重启；或者在智能体对话框中输入「请配置质数幻方 MCP」，并粘贴上面复制的 JSON，智能体即可自动完成 MCP 配置。

验证 MCP 接入效果

在对话中输入企业查询问题，例如“请查询华为技术有限公司的企业主体信息”。若正常返回企业工商信息，即说明 MCP 接入成功，可正常使用全部服务能力。

产品介绍

质数幻方提供企业主体、风险信息、经营情况、财务数据、知识产权五大 MCP 核心能力，助力 AI 商查场景。通过标准化的 MCP（Model Context Protocol）工具，开发者可以快速将企业信息查询能力集成到各类 AI 应用中，实现智能化企业查询、风险评估、商业决策支持等场景。

接入配置

认证方式

所有 MCP 请求需在 HTTP Header 中携带 Authorization 认证头，格式为 Bearer <API Key>。API Key 可在控制台"API 密钥"页面创建和管理。

"Authorization": "Bearer <API Key>"

所有 MCP 请求需在服务地址中携带服务代码：

https://mcp.yidian.cn/mcp/{service_code}

传输协议

Transport: streamable-http

入参/出参规范

以下为各工具可能使用的入参说明，具体每个工具支持的参数详见工具列表。

入参规范

出参规范

所有 MCP 工具的返回结果均遵循 MCP 协议标准响应格式。

响应示例：

{
  "content": [
    {
      "type": "text",
      "text": "{\"CODE\":200,\"MSG\":\"ok\",\"DATA\":{...}}"
    }
  ],
  "isError": false
}

MCP 工具列表

主体识别与查询

提供企业主体的身份识别与基础信息查询服务，包含企业模糊搜索、受益所有人结果、企业基本信息、变更信息、企业联系方式、主要人员信息、企业股东信息等工具。

风险信息

获取企业司法风险、运营风险及资产风险，覆盖失信被执行、裁判文书、经营异常、行政处罚、股权冻结等风险场景。

经营情况

洞察企业真实经营活力，涵盖资质许可、招投标动态、融资历程、信用评级、新闻舆情与招聘信息。

财务数据

结构化输出上市企业核心财务数据及分析指标，覆盖资产负债表、现金流量表、利润表及综合财务指标。

知识产权

评估企业科创硬实力，提供专利、商标、软件著作权、作品著作权及网络备案等知识产权信息。

调用示例

以下展示用户与 AI 交互时，MCP 工具的实际调用效果。

示例1：工商股东查询

问题：帮我查一下腾讯的工商信息和股东信息

AI 应用调用流程：

步骤1： 调用 get_company_precise_name

{
  "ent_name": "腾讯"
}

结果：返回匹配企业列表，确认全称为「深圳市腾讯计算机系统有限公司」

步骤2： 调用 get_registration_info

{
  "ent_name": "深圳市腾讯计算机系统有限公司"
}

结果：返回企业工商登记信息，包括法定代表人、注册资本、成立日期、经营状态等

步骤3： 调用 get_shareholder_info

{
  "ent_name": "深圳市腾讯计算机系统有限公司"
}

结果：返回企业股东及出资信息，辅助识别股权结构

示例2：风险信息查询

问题：查询腾讯是否存在经营异常、行政处罚和股权冻结风险

AI 应用调用流程：

步骤1： 调用 get_company_precise_name

{
  "ent_name": "腾讯"
}

结果：返回匹配企业列表，确认全称为「深圳市腾讯计算机系统有限公司」

步骤2： 调用 get_business_exception

{
  "ent_name": "深圳市腾讯计算机系统有限公司"
}

结果：返回经营异常记录，如无记录则返回空结果

步骤3： 调用 get_administrative_penalty

{
  "ent_name": "深圳市腾讯计算机系统有限公司"
}

结果：返回行政处罚记录，包含处罚决定、处罚机关、处罚日期等

步骤4： 调用 get_equity_freeze

{
  "ent_name": "深圳市腾讯计算机系统有限公司"
}

结果：返回股权司法冻结信息，用于辅助判断资产风险

示例3：招投标信息查询

问题：帮我查一下腾讯最近的招投标信息

AI 应用调用流程：

步骤1： 调用 get_company_precise_name

{
  "ent_name": "腾讯"
}

结果：返回匹配企业列表，确认全称为「深圳市腾讯计算机系统有限公司」

步骤2： 调用 get_bidding_info

{
  "ent_name": "深圳市腾讯计算机系统有限公司"
}

结果：返回招投标项目名称、中标情况、金额、招标单位等信息