OpenRegister MCP 服务器

这是一个非官方的模型上下文协议（MCP）服务器，用于访问 OpenRegister API，提供工具来搜索和检索德国公司注册中的公司信息。

功能

• 根据各种条件（名称、注册编号、类型等）搜索公司
• 获取详细的公司信息，包括历史、财务数据和文档
• 检索公司的股东信息

要求

• Python 3.9+
• uv
• OpenRegister API 密钥（您可以在创建账户后从 https://openregister.de 获取）
• Claude Desktop（或另一个理解 MCP 的 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",
                "<绝对路径到 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