MCP Server Demo

MCP サーバーのデモ

このプロジェクトでは、Model Context Protocol（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

インストール

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

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

2. 仮想環境を作成します（推奨）：

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

3. 依存関係をインストールします：

pip install -r requirements.txt

使用方法

1. MCP サーバーを起動します：

python src/server.py

2. サンプルクライアントを実行します：

python examples/client.py

仕組み

MCP サーバーは、次の主要なコンポーネントを実装しています：

1. コンテキスト管理：各セッションの会話履歴と関連するコンテキストを保持します。
2. ツールレジストリ：利用可能なツールとその仕様を管理します。
3. メッセージ処理：受信したメッセージを処理し、適切なツールに振り分けます。
4. WebSocket サーバー：クライアントとのリアルタイム通信を提供します。

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については LICENSE ファイルをご覧ください。