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 许可证。