MCP サーバーデモ

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーの実装を実証します。MCPは、コンテキスト認識を維持しながら、AIモデルと外部ツール／サービス間の通信を容易にするために設計されたプロトコルです。

特徴

基本的なMCPサーバーの実装
ツール統合の例
コンテキスト管理のデモンストレーション
WebSocketベースのリアルタイム通信
シンプルなクライアントの例

プロジェクト構造

mcp-server-demo/
├── src/
│   ├── server.py           # Main MCP server implementation
│   ├── tools/              # Tool implementations
│   │   ├── __init__.py
│   │   └── basic_tools.py
│   ├── context/            # Context management
│   │   ├── __init__.py
│   │   └── manager.py
│   └── utils/             # Utility functions
│       ├── __init__.py
│       └── helpers.py
├── examples/              # Example usage
│   ├── client.py
│   └── tools_demo.py
├── tests/                # Test cases
│   └── test_server.py
├── requirements.txt      # Project dependencies
└── README.md            # This file

インストール

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

git clone https://github.com/tian1ll1/mcp-server-demo.git
cd mcp-server-demo

仮想環境を作成します (推奨):

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

依存関係をインストールします:

pip install -r requirements.txt

使用法

MCP サーバーを起動します。

python src/server.py

サンプルクライアントを実行します。

python examples/client.py

仕組み

MCP サーバーは次の主要コンポーネントを実装します。

コンテキスト管理: 各セッションの会話履歴と関連コンテキストを維持します。
ツールレジストリ: 使用可能なツールとその仕様を管理します。
メッセージ処理: 受信メッセージを処理し、適切なツールにルーティングします。
WebSocket サーバー: クライアントとのリアルタイム通信を提供します。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。