MCP Server Setup

🚀 FastMCP サーバー

FastMCPは、特定の能力（ツールやリソースなど）を持つサーバーを簡単に構築できるツールです。このREADMEでは、FastMCPサーバーの実装、実行方法、クライアントの実装例について説明します。

🚀 クイックスタート

以下はFastMCPサーバーの基本的な実装例です。

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("DemoServer")

@mcp工具()
def say_hello(name: str) -> str:
    """向某人打招呼

    参数：
        name: 要打招呼的人的名字
    """
    return f"你好，{name}！见到你很高兴。"

if __name__ == "__main__":
    mcp运行()

📦 インストール

このサーバーを実行するには、mcpコマンドが必要です。以下に、サーバーを実行するいくつかの方法を示します。

1. 開発モードとMCPチェッカー

テストサーバーを実行する最も簡単な方法は、MCPチェッカーを使用することです。

mcp dev server.py

これにより、ローカルでサーバーが実行され、MCPチェッカーに接続されます。MCPチェッカーは、サーバーのツールやリソースと直接やり取りできるWebベースのツールです。テストに非常に便利です。

2. Claudeデスクトップ統合

Claude Desktopをインストールしている場合は、サーバーをClaudeで使用できるようにインストールできます。

mcp install server.py

これにより、サーバーがClaude Desktopの設定に追加され、Claudeから使用できるようになります。

3. 直接実行（必要な場合のみ）

サーバーを直接実行することもできます。

# 方法1：Pythonスクリプトとして実行
python server.py

# 方法2：UVを使用（推奨）
uv运行 server.py

💻 使用例

サーバーの実行時の挙動

サーバーを実行すると、以下のようなことが起こります。

1. サーバーが定義された能力（ツール、リソースなど）で初期化されます。
2. 特定のトランスポートプロトコルの接続を待機します。

デフォルトでは、MCPサーバーは従来のWebサーバーポートを使用しません。代わりに、以下のいずれかを使用します。

• 標準I/Oトランスポート：サーバーは標準入出力を介して通信します（mcp运行およびClaude Desktopとの統合時のデフォルト）
• SSEトランスポート：HTTPベースの通信（明示的に設定した場合）

HTTPを介して特定のポートでサーバーを公開する場合は、サーバーをSSEトランスポートを使用するように変更する必要があります。

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("MyServer", host="127.0.0.1", port=8050)

# 在这里添加你的工具和资源...

if __name__ == "__main__":
    mcp以SSE传输运行()

クライアントの実装例

標準I/Oを使用するクライアント

from subprocess import Popen, PIPE

# 启动服务器进程
server = Popen(["python", "server.py"], stdout=PIPE)

# 等待服务器准备完毕（实际实现中需要更复杂的握手）
input("按回车继续...")

# 调用say_hello工具
result = server.communicate(input=b'你好\n')

print(result)

SSEを使用するクライアント

import requests

# 连接SSE端点
response = requests.get('http://localhost:8050/sse', stream=True)

# 读取流数据
for line in response.iter_lines():
    if line:
        print(line.decode())

トランスポート方式の比較

• 標準I/Oを使用する場合：クライアントとサーバーが同じプロセスで実行されるか、クライアントから直接サーバープロセスを起動する場合に適しています。
• HTTPを使用する場合：サーバーがクライアントとは異なる場所（別のマシンやコンテナなど）で実行される場合に適しています。

ほとんどの本番環境のバックエンド統合では、HTTP方式が分離性と拡張性の面で優れています。一方、標準I/O方式は開発や密結合システムに適しています。