Data Commons MCP

🚀 EOSC Data Commons MCPサーバー

EOSC Data Commonsプロジェクト向けに開発された、様々なオープンアクセスデータパブリッシャーからデータにアクセスするためのHTTP POSTエンドポイントを公開するModel Context Protocol (MCP)サーバーです。

このサーバーは、検索APIと大規模言語モデル (LLM) を使用して、ユーザーが必要とするデータセットとツールを見つけるのを支援します。

🚀 クイックスタート

このセクションでは、EOSC Data Commons MCPサーバーの基本的な使い方を説明します。

✨ 主な機能

• HTTP APIを介して、様々なオープンアクセスデータパブリッシャーからデータにアクセスできます。
• 検索APIとLLMを使用して、ユーザーが必要とするデータセットとツールを見つけるのを支援します。

🧩 エンドポイント

HTTP APIは2つの主要なエンドポイントで構成されています。

• /mcp: MCPサーバー。EOSC Data Commons検索APIを使用して、ユーザーの質問に回答するための関連データを検索します。

  • ストリーミング可能なHTTPトランスポートでrmcpを使用します。
  • 利用可能なツール:
    • [x] データセットを検索する
    • [ ] ツールを検索する
    • [ ] データセットまたはツールに関連する引用を検索する

• /search: 単純なHTTP POSTエンドポイント (JSON)。LLMプロバイダーを介してMCPサーバーにクエリを送信するために使用します。

  • OpenAPI仕様の生成にaxum、utoipaを使用し、LLMプロバイダー (例: Mistral、OpenAI) とのやり取りにllmを使用します。
  • ストリーミングレスポンスを返します。ツール呼び出し要求、ツール呼び出し結果、および最終的な検索結果が返されます。

📦 インストール

開発環境の依存関係をインストールする

rustup update
cargo install cargo-release cargo-deny cargo-watch git-cliff

Mistral APIキーまたはOpenAI APIキーを含む.cargo/config.tomlファイルを作成します。

[env]
MISTRAL_API_KEY = "YOUR_API_KEY"
OPENAI_API_KEY = "YOUR_API_KEY"

開発サーバーを起動する

開発環境でMCPサーバーをhttp://localhost:8000/mcpで起動し、OpenAPI UIをhttp://localhost:8000/docsで利用できます。

cargo run

コードが変更されたときに自動的に再起動するには、次のコマンドを使用します。

cargo watch -x run

例としてのcurlリクエスト:

curl -X POST http://localhost:8000/search -H "Content-Type: application/json" -H "Authorization: SECRET_KEY" -d '{"messages": [{"role": "user", "content": "data about insulin in EU"}], "model": "mistral-small-latest", "stream": true}'

MCPクライアントを接続する

クライアントの指示に従い、デプロイされたサーバーの/mcpURL (例: http://localhost:8000/mcp) を使用します。

🐙 VSCode GitHub Copilot

VSCode UIを通じて新しいMCPサーバーを追加します。

• コマンドパレット (ctrl+shift+pまたはcmd+shift+p) を開きます。
• MCP: Add Server...を検索します。
• HTTPを選択し、MCPサーバーのURL http://localhost:8000/mcpを指定します。

VSCodeのmcp.jsonは次のようになります。

{
    "servers": {
        "data-commons-mcp-server": {
            "url": "http://localhost:8000/mcp",
            "type": "http"
        }
    },
    "inputs": []
}

本番用にビルドする

target/release/にバイナリをビルドします。

cargo build --release

サーバーを起動するには、次のコマンドを使用します。

./target/release/data-commons-mcp

🐳 Dockerでデプロイする

APIキーを含むkeys.envファイルを作成します。

MISTRAL_API_KEY=YOUR_API_KEY
SEARCH_API_KEY=SECRET_KEY_YOU_CAN_USE_IN_FRONTEND_TO_AVOID_SPAM

SEARCH_API_KEYは、LLMをスパムする可能性のあるボットから保護するためのレイヤーを追加するために使用できます。指定しない場合、APIにクエリを送信するためにAPIキーは必要ありません。

サービスをビルドしてデプロイします。

docker compose up

🧼 コードのフォーマットとリント

rustfmtを使用してコードベースを自動的にフォーマットします。

cargo fmt

clippyでリントします。

cargo clippy --all

可能な修正を自動的に適用します。

cargo fix

⛓️ サプライチェーンのチェック

依存関係のサプライチェーンをチェックします。ライセンス (OSIまたはFSFが承認したライセンスの依存関係のみを受け入れます) と脆弱性 (CVEアドバイザリー) を確認します。

cargo deny check

Cargo.lockの依存関係を更新します。

cargo update

🏷️ リリース

ドライランを実行します。

cargo release patch

またはminor / major

リリースを作成します。

cargo release patch --execute

⚠️ 重要提示

必要なもの:

• Rust
• LLMプロバイダーのAPIキー: Mistral.aiまたはOpenAI。無料プランを使用できますが、ログインが必要です。

推奨するVSCode拡張機能: rust-analyzer

💡 使用建议

SEARCH_API_KEYは、LLMをスパムする可能性のあるボットから保護するためのレイヤーを追加するために使用できます。指定しない場合、APIにクエリを送信するためにAPIキーは必要ありません。