MCP Datapi

🚀 気候データストレージ（CDS）MCP サーバー

このプロジェクトは、大型言語モデルにCDSディレクトリデータとタスク状態を取得するためのインターフェースを提供する、モデルコンテキストプロトコル（MCP）サーバーの実装です。基盤となる API は datapi で、そのドキュメントはこちらで確認できます。

✨ 主な機能

• ツール：
  • get_jobs：利用可能なタスクを検索し、必要に応じて状態でフィルタリングできます。タスク ID のリストを返します。
  • download_job_result：タスク ID を使用してタスク結果をダウンロードします。
  • get_all_collections：ディレクトリ内のすべての利用可能なコレクションの ID を取得します。
  • get_collection_by_id：指定されたコレクション ID で関連情報を取得します。
  • submit_job：ダウンロード要求を送信します。
• .env ファイルを使用した環境変数のサポート。

📦 インストール

前提条件

• Python 3.13 以上
• CDS API キー：こちらから取得
• MCP ホスト/クライアント：Claude デスクトップと MCP モニターでテスト済み

インストール手順

1. リポジトリをクローンします。

git clone git@github.com:albertdow/mcp-datapi.git
cd mcp-datapi

2. 依存関係をインストールします（uv を使用）。

uv add "mcp[cli]" datapi python-dotenv

3. .env ファイルを作成し、以下の内容を追加して CDS API キーを設定します。

DATAPI_URL=<DATAPI_URL>
DATAPI_KEY=<DATAPI_KEY>

CDS API キーの設定の詳細については、こちらを参照してください。

💻 使用例

開発モードと MCP モニター

ローカルでサーバーをテストするには、以下のコマンドを実行します。

mcp dev datapi_server.py

Claude デスクトップへの統合

以下のコマンドを使用して統合します。

mcp install datapi_server.py --name "DatapiServer" -f .env

または、claude_desktop_config.json に直接追加することもできます。

{
    "mcpServers": {
        "DatapiServer": {
            "command": "uv",
            "args": [
                "--directory",
                "mcp-datapi",
                "run",
                "datapi_server.py"
            ],
            "env": {
                "DATAPI_URL": "<DATAPI_URL>",
                "DATAPI_KEY": "<DATAPI_KEY>"
            }
        }
    }
}

⚠️ 重要提示

uv のパスを指定する必要があります。例えば /Users/username/.local/bin/uv のように指定します。