mcp

This MCP server exposes a suite of enterprise data capabilities through the STDIO-based deployment. It provides tools to query and analyze corporate information, including basic company profiles, shareholders, foreign investments, risk indicators, honors, and more. Specifically, you can use query_company_data to answer natural-language questions about a company and optionally visualize results; search_established_companies and search_established_selfemployed to filter by location and establishment date for companies and individual businesses; and get_company_info, get_company_partner, get_stie_score, get_company_risk, get_company_honor, get_company_contact, get_company_investment, get_company_cert, get_person_related_company, get_company_controller, and get_company_benificalowner to retrieve focused data facets such as照面信息, 股东信息, 科创能力评估, 风险信息, 荣誉资质、联系方式、对外投资、资质证书、关联企业、实控人及受益所有人等。使用者可以通过自然语言向系统提问，系统将返回对应的结构化信息或可选的可视化结果。

示例用法:

• 通过 query_company_data 提出问题，例如：“查一下某某有限公司的基本信息并按地区汇总成地图。”
• 使用 get_company_info 获取企业照面信息，使用 get_company_partner 查看股东结构，使用 get_company_risk 获取风险信息，使用 get_company_investment 查看对外投资历史。
• 通过 get_person_related_company 指定企业名称和人名，查询该人名在其他公司中的任职关系与股东身份。

Prerequisites:

• Python 3.8+（或兼容版本）
• uv（Unified Validator/Worker工具）按照官方文档安装，示例：参考 https://docs.astral.sh/uv/
• 具备 shuidi_pname 和 shuidi_pkey 的账号与权限（用于授权接入企业数据源）

安装步骤:

1. 安装 uv 工具（如果尚未安装）

• 按照 uv 官方文档进行安装，通常是通过安装包或包管理器完成。

2. 获取并准备 MCP 参数

• 在 cursor 配置中，将 DataMcpServer 的 url 配置为以下 STDIO 版本示例的工作流所需的路径与参数，示例配置如下（请在实际环境中替换为真实的工作目录与参数）：

在工作目录中创建并编辑 mcp.json（或通过 cursor 设置保存全局 MCP Server 配置）

3. 启动 MCP 服务器

• 使用 uv 启动： uv --directory {workdir} run src/mcp_server.py

4. 验证部署

• 通过日志确认服务器启动无错误，随后即可在 Cursor 等客户端工具中选择新建的 MCP Server 进行测试调用。

说明:

• 该 STDIO 版使用 uv 作为运行环境，命令配置如下所示（请替换为实际工作目录）：

"DataMcpServer":{
  "command": "uv",
  "args": [
    "--directory",
    "{workdir}",
    "run",
    "src/mcp_server.py"
  ],
  "env": {
    "shuidi_pname": "2025041486173046",
    "shuidi_pkey": "3303b6a7e64ac0b18b5f17aafde52c71"
  }
},

Note: workdir 是工作目录，shuidi_pname 与 shuidi_pkey 需到 Shuidi 官网申请，当前示例提供的是演示用的测试账号信息。

Tips and common issues:

• 确保 shuidi_pname 和 shuidi_pkey 有效且未过期；若密钥过期需在 Shuidi 官网重新申请。
• workdir 必须指向包含 mcp_server.py 的工作目录，且该目录对运行用户可读写。
• 对于企业数据查询，请确保网络环境对数据源有访问权限，且相关 API 端点未被防火墙拦截。
• 如果遇到启动失败，请查看 uv 的日志输出，以确认 Python 依赖、路径问题或权限错误等。如果需要对接其他平台（如 Node/npm 版本），当前配置不包含 npm 包信息。