Dockerized MCP Server Template

🚀 Dockerized MCP サーバーテンプレート

このリポジトリは、Docker コンテナで実行される Python サーバーを使用してモデルコンテキストプロトコル (MCP) を実装するための再利用可能なテンプレートを提供します。また、Server-Sent Events (SSE) を利用してリアルタイム通信を行います。このテンプレートは FastMCP ライブラリに基づいて構築されており、大規模言語モデル (LLMs) との統合を簡単に行えるようにしています。

✨ 主な機能

🔍 什么是 MCP？（原文未翻译，保留疑问，推测为“MCP とは何か？”）

モデルコンテキストプロトコル (MCP) は、大規模言語モデルとのやり取りに特化して設計された標準プロトコルです。MCP を使用すると、アプリケーションは LLM にコンテキスト（データと機能）を提供することと、実際の LLM とのやり取りを明確に分けることができます。MCP サーバーは以下を提供します。

• リソース：LLM にデータを提供します（GET エンドポイントに似ています）。
• ツール：LLM が操作や計算を実行できるようにします（POST エンドポイントに似ています）。
• プロンプトテンプレート：LLM との構造化されたやり取りに使用する再利用可能なテンプレートです。

このテンプレートは、Docker コンテナで実行される本番環境向けの MCP サーバーを示しており、Server-Sent Events (SSE) を利用してリアルタイム通信を行います。

📦 インストール

🚀 快速入门（推测为“クイックスタート”）

使用 Docker Compose 构建和运行（“Docker Compose を使用して構築し実行する”）

docker-compose up --build

サーバーは以下のアドレスからアクセスできます。

http://localhost:3000/sse

直接运行（不使用 Docker）（“直接実行する（Docker を使用しない）”）

Python を直接使用してサーバーを実行することもできます。まず、依存関係をインストールします。

pip install -r src/requirements.txt

次に、サーバーを実行します。

python src/server.py

サーバーは以下のアドレスからアクセスできます。

http://localhost:3000/sse

💻 使用例

基本的な使用法

サンプルには、単純な MCP ツール関数 add が含まれています。

@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

このツールは、MCP クライアントからのリクエストで呼び出すことができます。

📚 ドキュメント

🔗 リソース

• MCP ドキュメント
• MCP 仕様
• Server-Sent Events (SSE)