Model Context Protocol (MCP) Server for GraphQL Policies API について
TrueRAG 環境に関連する GraphQL API 経由でポリシーにアクセスする Python 製 MCP サーバーです。この API を照会する必要がある MCP クライアントを対象としています。
主な機能
- 01GraphQL API 経由でポリシーにアクセス
- 02MCP Python SDK と GQL ライブラリを使用
- 03環境変数で API キーとエンドポイントを設定
活用シーン
- 01MCP クライアントを TrueRAG GraphQL API に接続
- 02設定済み API からポリシー情報を取得
MCP 対応
MCP クライアントに TrueRAG GraphQL ポリシー API へのアクセスを提供します。API キーとエンドポイントは環境変数で設定します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
GraphQL Policies API 用 Model Context Protocol (MCP) サーバー
このリポジトリには、ポリシーにアクセスできる GraphQL API 用の Model Context Protocol (MCP) サーバー実装が含まれています。
このサーバーは MCP 用 Python SDK を使用して構築されており、GraphQL API との通信には GQL ライブラリを使用します。
はじめに
リポジトリをクローンする
git clone https://github.com/Ad-Veritas/mcp-server-trueRAG.git
cd mcp-server-trueRAG
uv がインストールされていることを確認する
uv --version
インストールされていない場合は、次のコマンドでインストールできます。
# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh
# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
環境変数を定義する
このサーバーは、いずれかの TrueRag システムの GraphQL API に接続するよう設定されています。TrueRAG 環境を作成したら、環境変数から API キーとエンドポイントをコピーします。
リポジトリのルートディレクトリに .env ファイルを作成し、次の行を追加します。
GRAPHQL_API_KEY = "{your_api_key}"
GRAPHQL_ENDPOINT = "{your_graphql_endpoint}"
Claude Desktop などの MCP クライアントに追加する
Claude の設定ファイル(~/Library/Application Support/Claude/claude_desktop_config.json)に次の行を追加します。
"shipping-policies": {
"command": "uv",
"args": [
"--directory",
"{path_to_mcp_server}/mcp-server-trueRAG",
"run",
"fastmcp",
"run",
"server.py"
]
}
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。