Openregister MCP

🚀 OpenRegister MCP Server

OpenRegister MCP Server 是一個非官方的模型上下文協議（MCP）服務器，用於訪問 OpenRegister API。它提供了從德國商業登記冊中搜索和檢索公司信息的工具，能幫助用戶快速獲取所需的公司數據。

✨ 主要特性

• 可根據多種條件（名稱、登記號、類型等）搜索公司。
• 獲取詳細的公司信息，包括歷史、財務狀況和相關文件。
• 檢索公司股東信息。

📦 安裝指南

環境要求

• Python 3.9 及以上版本
• uv
• OpenRegister API 密鑰（在 OpenRegister 創建賬戶後可獲取）
• Claude Desktop（或其他支持 MCP 的客戶端）

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/Syndicats/openregister-mcp.git
   cd openregister-mcp
   

2. 創建虛擬環境並安裝依賴：

   uv venv
   source .venv/bin/activate
   uv pip install "mcp[cli]" httpx dotenv
   

3. 根據示例創建 .env 文件：

   cp env.example .env
   

4. 將 OpenRegister API 密鑰添加到 .env 文件中：

   OPENREGISTER_API_KEY=your_api_key_here
   OPENREGISTER_API_URL=https://api.openregister.de/v0
   

💻 使用示例

作為 MCP 服務器使用

在 Claude Desktop 中運行服務器，例如通過編輯 Claude Desktop 的 claude_desktop_config.json 文件：

{
    "mcpServers": {
        "openregister": {
            "command": "uv",
            "args": [
                "--directory",
                "<Absolute Path to openregister-mcp>/openregister-mcp",
                "run",
                "server.py"
            ]
        }
    }
}

重啟 Claude Desktop 使更改生效。

⚠️ 重要提示

有時需要為 uv 使用絕對路徑，此時需要相應地更改 JSON 文件。

可用工具

服務器提供以下 MCP 工具：

1. search_companies - 根據多種條件搜索公司

   • 參數：
     • query：按名稱搜索公司的文本查詢
     • register_number：用於精確匹配的公司登記號
     • register_type：用於過濾結果的登記類型（例如，"HRB", "HRA", "PR", "GnR", "VR"）
     • register_court：公司註冊的法院
     • active：過濾活躍或非活躍公司（默認：true）
     • legal_form：公司的法律形式（例如，"gmbh", "ag", "ug"）

2. get_company_info - 使用公司唯一 ID 獲取詳細信息

   • 參數：
     • company_id：公司唯一標識符（例如，"DE-HRB-F1103-267645"）
     • history：包含公司歷史數據（默認：true）
     • financials：包含財務數據（默認：true）
     • documents：包含文檔元數據（默認：true）

3. get_company_shareholders - 檢索公司股東信息

   • 參數：
     • company_id：公司唯一標識符（例如，"DE-HRB-F1103-267645"）
   • 注意：目前僅支持法律形式為 GmbH 的公司。

📄 許可證

本項目採用 MIT 許可證。