MCP サーバー サンプル

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

MCP サーバーの例

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

参考文献:

• モデルコンテキストプロトコル - 人類学的。

• MCP - Python 。

MCPとは何ですか?

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

主なメリット

• LLMに直接接続できる、構築済みの統合のリストが増えています

• LLMプロバイダーとベンダーを切り替える柔軟性

• インフラストラクチャ内でデータを保護するためのベストプラクティス

Related MCP server: MCP Server Example

アーキテクチャの概要

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

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

リソース：

• モデルコンテキストプロトコルによるエージェントの構築 - AnthropicのMahesh Murag氏によるワークショップ

ライセンス

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