Companies House MCP Server

🚀 公司注册处MCP服务器

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

✨ 主要特性

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

🔧 技术细节

架构

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

📦 安装指南

前提条件

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

快速开始（Docker）

1. 构建镜像：

   docker build -t companies-house-mcp .
   

2. 运行容器：

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

3. 使用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"
    }
  }
}

📚 详细文档

工具参考

部署（Kubernetes）

1. 部署：

   kubectl apply -f k8s/deployment.yaml
   kubectl apply -f k8s/service.yaml
   

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

安全注意事项

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