Enterprise MCP Server

# 企业大数据服务 [该MCP服务提供企业工商信息、企业简介、企业标签、企业业务、企业控股股东信息、企业对外投资信息、企业分支机构信息、企业主要人员信息等基础查询功能。](https://www.handaas.com/) ## 主要功能 - 🔍 企业关键词模糊搜索 - 🏢 企业基础信息查询 - 👥 企业控股股东信息 - 💰 企业对外投资信息 - 🏪 企业分支机构信息 - 👨‍💼 企业主要人员信息 ## 环境要求 - Python 3.10+ - 依赖包：python-dotenv, requests, mcp ## 本地快速启动 ### 1. 克隆项目 ```bash git clone https://github.com/handaas/enterprise-mcp-server cd enterprise-mcp-server ``` ### 2. 创建虚拟环境&安装依赖 ```bash python -m venv mcp_env && source mcp_env/bin/activate pip install -r requirements.txt ``` ### 3. 环境配置 复制环境变量模板并配置： ```bash cp .env.example .env ``` 编辑 `.env` 文件，配置以下环境变量： ```env INTEGRATOR_ID=your_integrator_id SECRET_ID=your_secret_id SECRET_KEY=your_secret_key ``` ### 4. streamable-http启动服务 ```bash python server/mcp_server.py streamable-http ``` 服务将在 `http://localhost:8000` 启动。 #### 支持启动方式 stdio 或 sse 或 streamable-http ### 5. Cursor / Cherry Studio MCP配置 ```json { "mcpServers": { "handaas-mcp-server": { "type": "streamableHttp", "url": "http://127.0.0.1:8000/mcp" } } } ``` ## STDIO版安装部署 ### 设置Cursor / Cherry Studio MCP配置 ```json { "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配置 ```json { "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. 字节跳动的核心人员构成