MCP サーバーサンプル

このリポジトリには、教育目的のモデルコンテキストプロトコル（MCP）サーバーの実装が含まれています。このコードは、様々なLLMクライアントと統合できる機能的なMCPサーバーの構築方法を示しています。

MCP サーバーの例

参考文献:

MCPとは何ですか?

MCP（モデル・コンテキスト・プロトコル）は、アプリケーションがLLMにコンテキストを提供する方法を標準化するオープンプロトコルです。MCPはAIアプリケーション用のUSB-Cポートのようなもので、AIモデルをさまざまなデータソースやツールに接続するための標準化された方法を提供します。

主なメリット

LLMに直接接続できる、構築済みの統合のリストが増えています
LLMプロバイダーとベンダーを切り替える柔軟性
インフラストラクチャ内でデータを保護するためのベストプラクティス

アーキテクチャの概要

MCP は、ホストアプリケーションが複数のサーバーに接続できるクライアントサーバーアーキテクチャに従います。

MCPホスト: Claude Desktop、IDE、またはMCPを介してデータにアクセスするAIツールなどのプログラム
MCPクライアント: サーバーとの1:1接続を維持するプロトコルクライアント
MCP サーバー: 標準化されたモデルコンテキストプロトコルを通じて特定の機能を公開する軽量プログラム
データソース: MCP サーバーがアクセスできるローカル (ファイル、データベース) とリモートサービス (API) の両方

MCPコアコンセプト

MCP サーバーは、主に次の 3 種類の機能を提供できます。

リソース: クライアントが読み取ることができるファイルのようなデータ (API レスポンスやファイルの内容など)
ツール: LLM から呼び出せる関数 (ユーザーの承認が必要)
プロンプト: ユーザーが特定のタスクを達成するのに役立つ、事前に作成されたテンプレート

システム要件

Python 3.10以上
MCP SDK 1.2.0以上
uvパッケージマネージャー

インストール

Python プロジェクトに MCP を追加する Python プロジェクトを管理するには、uv を使用することをお勧めします。

UV 管理プロジェクトをまだ作成していない場合は、作成します。

uv init mcp-server-sample
cd mcp-server-sample

次に、プロジェクトの依存関係に MCP を追加します。

uv add "mcp[cli]

あるいは、依存関係に pip を使用するプロジェクトの場合:

pip install "mcp[cli]"

スタンドアロン MCP 開発ツールの実行 uv で mcp コマンドを実行するには:

uv run mcp

クイックスタート

計算ツールといくつかのデータを公開するシンプルな MCP サーバーを作成しましょう。

# server.py
from mcp.server.fastmcp import FastMCP

# Create an MCP server
mcp = FastMCP("Demo")


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


# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

次のコマンドを実行すると、このサーバーを Claude Desktop にインストールしてすぐに操作することができます。

mcp install server.py

あるいは、MCP Inspector を使用してテストすることもできます。

mcp dev server.py

アントニオ・スカペラートが❤️を込めて作りました

ライセンス

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

MCP Server Sample

Integrations