Model Context Protocol Server

Model Context Protocol サーバー

モデルコンテキストの管理、セッション処理、プロトコル操作を行う、FastAPI ベースの Model Context Protocol（MCP）サーバー実装です。

特徴

• FastAPI ベースの REST API サーバー
• モデルコンテキストの管理
• セッション処理と永続化
• リアルタイム更新のための WebSocket サポート
• 認証と認可
• リクエストの検証とエラー処理
• Swagger/OpenAPI ドキュメント
• Docker サポート

プロジェクト構成

mcp-protocol-server/
├── app/
│   ├── __init__.py
│   ├── main.py
│   ├── config.py
│   ├── core/
│   │   ├── __init__.py
│   │   ├── context.py
│   │   ├── session.py
│   │   └── protocol.py
│   ├── api/
│   │   ├── __init__.py
│   │   ├── endpoints/
│   │   │   ├── __init__.py
│   │   │   ├── context.py
│   │   │   └── session.py
│   │   └── dependencies.py
│   ├── models/
│   │   ├── __init__.py
│   │   ├── context.py
│   │   └── session.py
│   └── utils/
│       ├── __init__.py
│       └── security.py
├── tests/
│   ├── __init__.py
│   ├── conftest.py
│   ├── test_context.py
│   └── test_session.py
├── docker/
│   ├── Dockerfile
│   └── docker-compose.yml
├── requirements.txt
├── .env.example
└── README.md

インストール

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

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

2. 仮想環境を作成して有効化します：

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

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

pip install -r requirements.txt

4. サンプル環境ファイルをコピーし、設定を行います：

cp .env.example .env

サーバーの実行

開発モード

uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

本番モード

uvicorn app.main:app --host 0.0.0.0 --port 8000 --workers 4

Docker を使用する場合

docker-compose up -d

API ドキュメント

サーバーの起動後、次の URL から API ドキュメントにアクセスできます：

• Swagger UI：http://localhost:8000/docs
• ReDoc：http://localhost:8000/redoc

テスト

テストスイートを実行します：

pytest

設定

サーバーは環境変数または .env ファイルを使用して設定できます。利用可能なオプションについては .env.example を参照してください。

ライセンス

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