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傳輸密鑰。