fastmcp

FastMCPとは

FastMCPは、Model Context Protocol (MCP) サーバーを簡単に構築するためのPythonフレームワークです。Pythonの関数をデコレータで装飾するだけで、MCPサーバーを素早く構築できます。

🎉 FastMCPは現在、公式のMCP SDKに統合されています！ 公式のModel Context Protocol Python SDK: github.com/modelcontextprotocol/python-sdk

主な特徴

• 高速: 高レベルなインターフェースにより、少ないコードで迅速な開発が可能
• シンプル: 最小限のボイラープレートコードでMCPサーバーを構築
• Pythonic: Python開発者にとって自然な感覚で使用可能
• 完全: MCPの仕様を完全に実装することを目指している

インストール方法

FastMCPは uv を使ってインストールすることが推奨されています：

uv pip install fastmcp

macOSでは、Claude Desktopアプリで利用するために、Homebrewを使って uv をインストールする必要がある場合があります：

brew install uv

あるいは、デプロイせずにSDKを使用する場合は、pipを使用することもできます：

pip install fastmcp

クイックスタート

以下は、簡単な計算ツールを提供するMCPサーバーの例です：

# server.py
from fastmcp import FastMCP

# MCPサーバーの作成
mcp = FastMCP("Demo")

# 足し算ツールの追加
@mcp.tool()
def add(a: int, b: int) -> int:
    """二つの数値を足し算する"""
    return a + b

# サーバーの実行
if __name__ == "__main__":
    mcp.run()

これだけで、動作するMCPサーバーが完成します！

主要コンポーネント

FastMCPは以下の主要コンポーネントをサポートしています：

1. サーバー

サーバーはFastMCPのメインオブジェクトで、すべての機能の中心となります：

from fastmcp import FastMCP

mcp = FastMCP(
    "サーバー名",
    host="0.0.0.0",  # オプション
    port=52229,      # オプション
)

2. ツール

ツールはLLMが呼び出せる関数です。デコレータを使って簡単に定義できます：

@mcp.tool()
def my_tool(param1: str, param2: int) -> str:
    """
    ツールの説明
    
    Args:
        param1: 最初のパラメータの説明
        param2: 2番目のパラメータの説明
        
    Returns:
        結果の説明
    """
    # ツールの実装
    return f"結果: {param1}, {param2}"

3. リソース

リソースはLLMがアクセスできるデータです：

@mcp.resource("echo://{message}")
def echo_resource(message: str) -> str:
    """リソースとしてメッセージをエコーする"""
    return f"Resource echo: {message}"

4. プロンプト

プロンプトはLLMに特定のタスクを実行させるための指示です：

@mcp.prompt()
def analyze_table(table: str) -> str:
    """テーブル分析用のプロンプトテンプレートを作成する"""
    return f"""このデータベーステーブルを分析してください:
テーブル: {table}
スキーマ: 
{get_schema()}

構造と関係性についてどのような洞察を提供できますか？"""