Freedanfan MCP Server

🚀 MCP サーバー

このプロジェクトはFastAPIとMCP（モデルコンテキストプロトコル）を基に構築されており、AIモデルと開発環境間の標準化されたコンテキストインタラクションを実現します。モデルのデプロイを簡素化し、効率的なAPIエンドポイントを提供し、入出力の一貫性を確保することで、AIアプリケーションの拡張性と保守性を向上させ、開発者がAIタスクをより簡単に統合および管理できるようにします。

MCP（Model Context Protocol）は、AIモデルと開発環境間の統一されたコンテキストインタラクションプロトコルです。このプロジェクトでは、PythonベースのMCPサーバー実装を提供しており、初期化、サンプリング、セッション管理などの基本的なMCPプロトコル機能をサポートしています。

🚀 クイックスタート

このセクションでは、MCPサーバーの基本的な使い方を説明します。

サーバー起動

mcp_server.py スクリプトを実行してMCPサーバーを起動します。

python mcp_server.py

デフォルトでは、サーバーはポート8000で動作します。環境変数 MCP_SERVER_HOST と MCP_SERVER_PORT を使用して、ホストとポートをカスタマイズすることができます。

クライアント使用

mcp_client.py でサーバーアドレスやその他のパラメータを設定した後、関連する機能を呼び出すことができます。例えば：

from mcp_client import MCPClient

client = MCPClient(server_url="http://localhost:8000")
response = client.request("command", parameters)
print(response)

✨ 主な機能

• JSON-RPC 2.0：標準のJSON-RPC 2.0プロトコルに基づくリクエスト-レスポンス通信をサポートします。
• SSE 接続：サーバー送信イベント（Server-Sent Events）接続をサポートし、リアルタイム通知を実現します。
• モジュール化設計：モジュール化アーキテクチャを採用しており、拡張とカスタマイズが容易です。
• 非同期処理：FastAPIと非同期IOを使用して、高性能なサービスを実現します。
• 完全なクライアント：包括的なテストクライアント実装を含んでいます。

📦 インストール

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

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

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

pip install -r requirements.txt

📚 ドキュメント

詳細なドキュメントは、プロジェクトリポジトリの docs ディレクトリを参照してください。APIリファレンス、使用ガイド、開発説明が含まれています。

📄 ライセンス

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

🔧 技術詳細

プロジェクト構造

mcp_server/
├── mcp_server.py         # MCP サーバー主プログラム
├── mcp_client.py         # MCP クライアントテストプログラム
├── routers/
│   ├── __init__.py       # ルーターパッケージ初期化
│   └── base_router.py    # 基礎ルーター実装
├── requirements.txt      # プロジェクト依存関係
└── README.md             # プロジェクトドキュメント