JinDaGe - companies-house-mcp-server MCP Details

article

README

🚀 公司注册处MCP服务器

公司注册处MCP服务器是一个模型上下文协议（MCP）服务器，它提供了与英国公司注册处API进行交互的工具。该服务器允许人工智能代理（如Claude）搜索公司、检索公司资料、查询公司高管信息，并生成全面的尽职调查报告。

✨ 主要特性

公司搜索：可通过公司名称或编号查找公司。
公司资料：获取详细的公司信息（状态、地址、类型）。
高管列表：检索现任和已离职的董事/秘书信息。
申报历史：访问已提交的账目、确认声明及其他文件。
抵押信息：查看未偿还和已结清的抵押情况。
破产信息：查询公司是否正在进行破产程序。
重要控制人：识别对公司有重大控制权的人员。
综合报告：generate_company_report 函数可将上述所有信息汇总成一份综合报告，包括计算董事的股东百分比。

🔧 技术细节

架构

传输协议：HTTP（无状态可流式传输），非常适合公共/云部署。
身份验证：客户端注入API密钥（用户需自行提供密钥）。
技术栈：Python、FastMCP、Docker、Kubernetes。

📦 安装指南

前提条件

公司注册处API密钥：你必须从公司注册处开发者中心获取一个“实时”API密钥。
Docker（用于本地运行）。
Kubernetes（可选，用于部署）。

快速开始（Docker）

构建镜像：
```
docker build -t companies-house-mcp .
```

运行容器：

docker run -p 8001:8001 companies-house-mcp

使用Postman进行测试：
- 导入 mcp_postman_collection.json。
- 将 apiKey 变量设置为你的公司注册处API密钥。
- 向 http://localhost:8001/mcp 发送POST请求。

💻 使用示例

与Claude桌面版（或其他MCP客户端）配合使用

配置你的MCP客户端以连接到服务器。由于此服务器使用 HTTP传输协议，你可能需要一个适配器或支持HTTP MCP的客户端。

工具调用示例（JSON - RPC）

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_company_report",
    "arguments": {
      "company_number": "00000006",
      "api_key": "YOUR_REAL_API_KEY"
    }
  }
}

📚 详细文档

工具参考

| 工具名称 | 描述 | 参数 | |-----------|-------------|-----------| | search_companies | 搜索公司 | q（查询词）, api_key | | get_company_profile | 获取公司基本信息 | company_number, api_key | | get_company_officers | 列出公司董事/秘书 | company_number, api_key | | generate_company_report | 最适合代理使用。返回完整的公司资料、高管信息和股权信息 | company_number, api_key |

部署（Kubernetes）

部署：
```
kubectl apply -f k8s/deployment.yaml
kubectl apply -f k8s/service.yaml
```
(注意：如果你依赖客户端密钥，secret.yaml 不再是严格必需的，但可用于设置服务器端默认值)
访问服务：该服务通过NodePort在端口 30001 暴露（或根据你的K8s设置使用LoadBalancer）。

安全注意事项

本服务器设计为无状态，不会存储你的API密钥。密钥会随每个请求传递，或通过环境变量进行配置（可选备用方式）。在生产环境中，请确保通过HTTPS传输密钥。

companies-house-mcp-server