MCP Knowledge Base

MCP ナレッジベース

シンプルな MCP クライアント・サーバー

必要条件

• Python 3.9 以降
• 依存関係の管理用の Poetry
• OpenAI API キー

セットアップ

1. Poetry を使って依存関係をインストールします。

   poetry install
   

2Create プロジェクトのルートディレクトリまたは親ディレクトリに、OpenAI API キーを記載した .env ファイルを作成します。

OPENAI_API_KEY=your_api_key_here

プロジェクト構成

• server.py：ツールを含む MCP サーバーの実装
• client-sse.py：LLM 機能を備えた MCP クライアントの実装
• data/kb.json：MCP 関連の Q&A を含むナレッジベースのデータ
• pyproject.toml：Poetry の設定ファイル

アプリケーションの実行

1. サーバーを起動します。

   poetry run python server.py
   

2. 別のターミナルでクライアントを実行します。

   poetry run python client-sse.py
   

クライアントの使用

クライアントには 2 つのモードがあります。

1. ツールを直接呼び出す：

   • client-sse.py の asyncio.run(test_direct_tool_calls()) の行のコメントを解除します
   • LLM を使わずにツールを直接呼び出します

2. LLM を利用した対話（デフォルト）：

   • OpenAI を使ってクエリを解釈し、適切なツールを呼び出します
   • 「MCP とは何ですか？」や「stdio トランスポートと SSE トランスポートの違いは何ですか？」などの質問をします

カスタマイズ

• @mcp.tool() デコレーターを使って関数を追加し、server.py に新しいツールを追加します
• data/kb.json を更新してナレッジベースを変更します
• MCPClient クラスの model パラメーターを変更して、OpenAI のモデルを変更します