MCP Protocol Server

🚀 モデルコンテキストプロトコルサーバ

FastAPIをベースにしたモデルコンテキストプロトコル（MCP）サーバで、モデルコンテキスト管理、セッション処理、プロトコル操作を担当します。

🚀 クイックスタート

このサーバはFastAPIを用いて開発され、モデルコンテキスト管理やセッション処理などの機能を提供します。以下の手順でサーバを起動できます。

✨ 主な機能

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

📦 インストール

1. リポジトリをクローン

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

2. 仮想環境を作成してアクティブ化

python -m venv venv
source venv/bin/activate  # 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ドキュメント

サーバを起動した後、以下のアドレスからAPIドキュメントにアクセスできます。

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

テスト

テストスイートを実行するには、以下のコマンドを実行します。

pytest

設定

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

🔧 技術詳細

プロジェクト構造

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

📄 ライセンス

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