金大哥 - openregister-mcp MCP 详情

article

README

🚀 OpenRegister MCP Server

OpenRegister MCP Server 是一个非官方的模型上下文协议（MCP）服务器，用于访问 OpenRegister API。它提供了从德国商业登记册中搜索和检索公司信息的工具，能帮助用户快速获取所需的公司数据。

✨ 主要特性

可根据多种条件（名称、登记号、类型等）搜索公司。
获取详细的公司信息，包括历史、财务状况和相关文件。
检索公司股东信息。

📦 安装指南

环境要求

Python 3.9 及以上版本
uv
OpenRegister API 密钥（在 OpenRegister 创建账户后可获取）
Claude Desktop（或其他支持 MCP 的客户端）

安装步骤

克隆仓库：

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

创建虚拟环境并安装依赖：

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

根据示例创建 .env 文件：
```
cp env.example .env
```

将 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 工具：

search_companies - 根据多种条件搜索公司
- 参数：
  - query：按名称搜索公司的文本查询
  - register_number：用于精确匹配的公司登记号
  - register_type：用于过滤结果的登记类型（例如，"HRB", "HRA", "PR", "GnR", "VR"）
  - register_court：公司注册的法院
  - active：过滤活跃或非活跃公司（默认：true）
  - legal_form：公司的法律形式（例如，"gmbh", "ag", "ug"）
get_company_info - 使用公司唯一 ID 获取详细信息
- 参数：
  - company_id：公司唯一标识符（例如，"DE-HRB-F1103-267645"）
  - history：包含公司历史数据（默认：true）
  - financials：包含财务数据（默认：true）
  - documents：包含文档元数据（默认：true）
get_company_shareholders - 检索公司股东信息
- 参数：
  - company_id：公司唯一标识符（例如，"DE-HRB-F1103-267645"）
- 注意：目前仅支持法律形式为 GmbH 的公司。

📄 许可证

本项目采用 MIT 许可证。

openregister-mcp