企业大数据服务

该MCP服务提供企业工商信息、企业简介、企业标签、企业业务、企业控股股东信息、企业对外投资信息、企业分支机构信息、企业主要人员信息等基础查询功能。

主要功能

• 🔍 企业关键词模糊搜索
• 🏢 企业基础信息查询
• 👥 企业控股股东信息
• 💰 企业对外投资信息
• 🏪 企业分支机构信息
• 👨‍💼 企业主要人员信息

环境要求

• Python 3.10+
• 依赖包：python-dotenv, requests, mcp

本地快速启动

1. 克隆项目

git clone https://github.com/handaas/enterprise-mcp-server
cd enterprise-mcp-server

2. 创建虚拟环境&安装依赖

python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt

3. 环境配置

复制环境变量模板并配置：

cp .env.example .env

编辑 .env 文件，配置以下环境变量：

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. streamable-http启动服务

python server/mcp_server.py streamable-http

服务将在 http://localhost:8000 启动。

支持启动方式 stdio 或 sse 或 streamable-http

5. Cursor / Cherry Studio MCP配置

{
  "mcpServers": {
    "handaas-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

STDIO版安装部署

设置Cursor / Cherry Studio MCP配置

{
  "mcpServers": {
    "enterprise-mcp-server": {
      "command": "uv",
      "args": ["run", "mcp", "run", "{workdir}/server/mcp_server.py"],
      "env": {
        "PATH": "{workdir}/mcp_env/bin:$PATH",
        "PYTHONPATH": "{workdir}/mcp_env",
        "INTEGRATOR_ID": "your_integrator_id",
        "SECRET_ID": "your_secret_id",
        "SECRET_KEY": "your_secret_key"
      }
    }
  }
}

使用官方Remote服务

1. 直接设置Cursor / Cherry Studio MCP配置

{
  "mcpServers": {
    "enterprise-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/enterprise/enterprise_profile?token={token}"  
      }
  }
}

注意：integrator_id、secret_id、secret_key及token需要登录 https://www.handaas.com/ 进行注册开通平台获取

可用工具

1. enterprise_get_keyword_search

功能: 关键词模糊查询企业

根据提供的企业名称、人名、品牌、产品、岗位等关键词模糊查询相关企业列表。

参数:

• matchKeyword (必需): 匹配关键词 - 查询各类信息包含匹配关键词的企业
• pageIndex (可选): 分页开始位置
• pageSize (可选): 分页结束位置 - 一页最多获取50条数据

返回值:

• catchReason: 命中原因
• address: 地址
• enterpriseType: 企业类型
• foundTime: 成立时间
• homepage: 官网
• legalRepresentative: 法人
• name: 企业名称
• operStatus: 经营状态
• regCapitalCoinType: 注册资本币种
• regCapitalValue: 注册资本
• annualTurnover: 年营业额

2. enterprise_get_enterprise_base_info

功能: 查询企业基础信息

通过输入企业全称查询企业业务相关信息，识别该公司是做什么的。

参数:

• keyword (必需): 企业全称

返回值:

• base_info: 企业工商信息
• desc: 企业简介
• business_info: 企业业务
• tag: 企业标签

3. enterprise_get_enterprise_holder_info

功能: 查询企业控股股东信息

通过输入企业全称查询企业控股股东信息，该信息通过工商信息及旷湖全部数据分析得出。

参数:

• keyword (必需): 企业全称

返回值:

• holderList: 股东列表（工商公示）
  • entityType: 主体类型
  • holderType: 股东类型
  • name: 股东名称
  • nameId: 企业id
  • humanId: 人员id
  • payAmount: 实缴金额
  • ratio: 持股比例
  • subscriptionDetail: 认缴信息
• stockHolderList: 股东列表（最新公示）来自于上市信息

4. enterprise_get_enterprise_invest_info

功能: 查询企业对外投资信息

通过输入企业全称查询企业的对外投资信息，该信息通过工商信息及旷湖全部数据分析得出。

参数:

• keyword (必需): 企业全称

返回值:

• resultList: 对外投资结果列表
  • addressValue: 被投资公司所属地区
  • business: 被投资公司经营范围
  • foundTime: 被投资公司成立日期
  • isListed: 被投资公司上市状态
  • legalRepresentative: 被投资公司法定代表人
  • name: 对外投资企业名
  • operStatus: 对外投资企业经营状态
  • ratio: 占股比例
  • regCapital: 被投资公司注册资本
  • scCode: 对外投资企业统一信用编码
  • subscriptionAmount: 投资金额信息

5. enterprise_get_enterprise_branch_info

功能: 查询企业分支机构信息

通过输入企业全称查询企业的分支机构信息，分支机构信息来源于工商公示。

参数:

• keyword (必需): 企业全称

返回值:

• resultList: 分支机构结果列表
  • addressValue: 地址信息
  • foundTime: 成立时间
  • legalRepresentative: 法定代表人
  • name: 机构名称
  • operStatus: 经营状态
  • orgCode: 组织机构代码
  • registrationAuthority: 登记机关
  • socialCreditCode: 统一社会信用代码

6. enterprise_get_enterprise_main_person_info

功能: 查询企业主要人员信息

通过输入企业全称查询企业的主要人员信息，主要人员信息来源于工商公示。

参数:

• keyword (必需): 企业全称

返回值:

• resultList: 主要人员结果列表
  • name: 成员名称
  • position: 职位
  • ratio: 持股比例
  • relatedEnterpriseCurrentNum: 现任职企业数
  • relatedEnterpriseHistoryNum: 曾任职企业数

使用注意事项

1. 企业全称要求: 在调用需要企业全称的接口时，需要先调用关键词模糊查询企业接口进行补全后，再调用该接口。
2. API限制: 分页查询时，一页最多获取50条数据。
3. 错误处理: 所有接口都包含错误处理，查询失败时会返回相应的错误信息。

使用提问示例

enterprise_get_keyword_search (企业关键词模糊搜索)

1. 帮我查找包含"探迹"关键词的企业信息
2. 搜索与"腾讯"相关的企业列表
3. 查询名称中包含"阿里巴巴"的公司

enterprise_get_enterprise_base_info (企业基础信息查询)

1. 探迹科技是做什么的？
2. 腾讯科技有限公司的主营业务是什么？
3. 北京字节跳动科技有限公司的企业简介

enterprise_get_enterprise_holder_info (企业控股股东信息)

1. 探迹科技有哪些股东？
2. 腾讯的控股股东都有谁？
3. 查询字节跳动的股权结构信息

enterprise_get_enterprise_invest_info (企业对外投资信息)

1. 探迹科技对外投资了哪些企业？
2. 腾讯投资了哪些公司？
3. 阿里巴巴的投资组合有哪些？

enterprise_get_enterprise_branch_info (企业分支机构信息)

1. 探迹科技有哪些分公司？
2. 腾讯在全国有哪些分支机构？
3. 华为的分公司分布情况

enterprise_get_enterprise_main_person_info (企业主要人员信息)

1. 探迹科技的主要管理人员有哪些？
2. 腾讯的高管团队信息
3. 字节跳动的核心人员构成