Openregister MCP

🚀 OpenRegister MCP Server

ドイツの会社登記簿から会社情報を検索および取得するための、OpenRegister APIにアクセスするための非公式のModel Context Protocol (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. .envファイルにOpenRegister APIキーを追加します：

   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