← ブログ一覧
AI10分

FastMCPとは?Pythonの関数をデコレータだけでMCPサーバーのツール・リソース・プロンプトに変換するフレームワークを実際に動かしてみた

  • #FastMCP
  • #MCP
  • #Python

サーバーを立てて、クライアントを立てて、JSON-RPCのやり取りを自分で書いて……MCP(Model Context Protocol)対応のツールを自作しようとすると、プロトコル部分だけで手間がかかります。Pythonの「FastMCP」は、普通の関数に@mcp.toolのようなデコレータを付けるだけで、その関数をMCPのツール・リソース・プロンプトとして公開できるフレームワークです。公式リポジトリ(jlowin/fastmcp)のREADMEは、FastMCPを「The fast, Pythonic way to build MCP servers and clients」と説明しています。

この記事は、公式GitHubリポジトリのREADME・LICENSE・pyproject.toml・docsディレクトリ内の公式ドキュメント(Getting Started、Resources、Prompts、Running the Server)を一次情報としています。公式サイト(gofastmcp.com)は、このクラウド環境のネットワークポリシー上アクセスできなかったため、そちらのWeb版の表示や検索は未確認です。一方で、FastMCP自体はこの環境にuv add fastmcpで実際にインストールでき、サンプルサーバーの作成、ツール・リソース・プロンプトの呼び出し、CLIコマンドの実行まで、このクラウド環境で実際に動かして確認しました。本文中「実際の出力」と明記した部分のみが、このクラウド環境で得た結果です。

FastMCPとは:関数をMCPサーバーに変換するPythonフレームワーク

READMEによると、FastMCPは「サーバー」「クライアント」「対話的なアプリ」という3つの領域を1つのAPIでカバーするPython製フレームワークです。ドキュメント(Getting Started)には「FastMCP created the high-level Python API later adopted by the official MCP Python SDK」とあり、FastMCP 1.0が2024年に公式のMCP Python SDKへ取り込まれたという経緯が説明されています。現在のFastMCPはその後継にあたる独立プロジェクトで、クライアント機能やサーバーの合成、OpenAPI/FastAPIからの自動生成、認証といった機能を追加しているとREADMEに記載されています。pyproject.tomlによると開発者はJeremiah LowinとNate Nowackで、ライセンスはApache License 2.0です。LICENSEファイルの内容を確認したところ、確かにApache License 2.0の全文が収録されていました。

インストールして動かしてみた:uv add からfastmcp inspectまで

READMEが案内するインストール方法はuv add fastmcpです。このクラウド環境にはuvがすでに入っていたため、仮想環境を作って実際にインストールしてみました。

uv venv .venv
uv pip install --python .venv/bin/python fastmcp

インストールは数十秒で完了し、pydantic・starlette・uvicorn・rich・pyjwtなど、Webサーバーや認証に関わる依存パッケージが一括で入りました。続けてfastmcp versionを実行すると、次の情報が表示されました(実際の出力)。

FastMCP version:                                                  4.2.2
MCP version:                                                      2.3.0
Python version:                                                 3.11.18

検索で見つかるPyPIのページには2.x〜3.xの表記も残っていましたが、このクラウド環境に実際に入ったのはバージョン4.2.2でした。公式リポジトリのバージョンはuv-dynamic-versioningによってgitのタグから動的に決まる仕組みのため、インストール時点の最新版を確認するのが確実です。

@mcp.toolでツールを定義する:実際に呼び出してみた

公式ドキュメント(Getting Started)のサンプルどおり、通常のPython関数に@mcp.toolを付けるだけのサーバーを作成しました。

from fastmcp import FastMCP

mcp = FastMCP("Demo 🚀")

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

if __name__ == "__main__":
    mcp.run()

このサーバーに対して、FastMCPが提供するClientクラスをインメモリ接続で使い、実際にツールを呼び出してみました。

async with Client(mcp) as client:
    tools = await client.list_tools()
    result = await client.call_tool("add", {"a": 2, "b": 3})

実行すると、次の結果が返りました(実際の出力)。

TOOLS: ['add']
CALL add(2,3) -> 5

@mcp.toolを付けた瞬間に、関数名・型ヒント・docstringから、ツール名・入力スキーマ・説明文がそのままMCPのツール定義として公開される、という設計をこの最小例で確認できました。

リソースとリソーステンプレート:URIでデータを公開する

公式ドキュメント(Resources)によると、リソースはMCPクライアントがURIで要求できる読み取り専用のデータです。静的な値だけでなく、URIに{name}のようなプレースホルダーを埋め込む「リソーステンプレート」を使うと、個々のリソースを事前に登録せずに、パラメータに応じて動的に生成できるとされています。次の2つを同じサーバーに追加しました。

@mcp.resource("config://app/settings", mime_type="application/json")
def app_settings() -> dict:
    """Return application settings."""
    return {"theme": "dark", "max_items": 50}

@mcp.resource("user://profile/{name}")
def user_profile(name: str) -> dict:
    """Return a profile for the requested user."""
    return {"name": name.title(), "role": "member"}

クライアントからconfig://app/settingsと、事前登録していないuser://profile/adaをそれぞれ読み取ると、次のように返ってきました(実際の出力)。

READ config://app/settings -> {"theme": "dark", "max_items": 50}
READ user://profile/ada -> {"name": "Ada", "role": "member"}

ドキュメントの説明どおり、user://profile/adaはコード上に個別登録していないURIですが、テンプレートの{name}にadaが当てはまる形で関数が実行され、その場で値が生成されていることが実際の出力から確認できました。ドキュメントには、パス全体を受け取るワイルドカード({path*})や、デフォルトで../のようなパストラバーサル的な値を拒否する検証が入っている旨の記載もありますが、これらは今回の最小例では検証していません。

@mcp.promptで再利用可能な会話テンプレートを作る

公式ドキュメント(Prompts)は、プロンプトを「LLMの応答を導くための、パラメータ化された再利用可能なメッセージテンプレート」と説明しています。関数が返すのは1件の文字列(ユーザーメッセージ1件になる)、またはMessageのリスト(会話全体)です。

from fastmcp.prompts import Message

@mcp.prompt
def review_request(language: str, code: str) -> list[Message]:
    """Asks the model to review a code snippet."""
    return [
        Message(f"Review this {language} code for bugs:\n\n{code}"),
        Message("Sure, I'll look for bugs and style issues.", role="assistant"),
    ]

このプロンプトにlanguage="python"と適当なコード断片を渡して取得すると、次のメッセージ列が返りました(実際の出力)。

PROMPT MESSAGE: user -> Review this python code for bugs:

def f(x): return x+1
PROMPT MESSAGE: assistant -> Sure, I'll look for bugs and style issues.

関数の引数(language・code)がそのままプロンプトの入力パラメータとしてクライアント側に公開され、デフォルト値のない引数は必須パラメータとして扱われる、という仕組みを実際の呼び出しで確認できました。

サーバーの起動方法とCLI:fastmcp run / fastmcp inspect

公式ドキュメント(Running the Server)によると、mcp.run()はtransport引数で動作を切り替えられます。引数なしの既定はSTDIO(クライアントがサーバープロセスをその都度起動する方式)、transport="http"はHTTPエンドポイント(既定で/mcp)を立てて複数クライアントを待ち受ける方式、transport="sse"は旧来のクライアント向けの方式で、新規プロジェクトにはHTTPが推奨されています。非同期コードの中ではrun()ではなくawait mcp.run_async(...)を使う、という注意点も記載されています。

スクリプトを直接実行する以外に、サーバーファイルを指定して起動するfastmcp runコマンドも用意されています。ドキュメントにはfastmcp run server.py --transport httpや、依存パッケージを追加する--with pandas、変更を検知して再起動する--reloadといったオプションが載っています。このクラウド環境では、サーバーを定義したファイルに対してfastmcp inspectを実行し、登録されているツール・リソース・プロンプトの数を一覧できることを確認しました(実際の出力)。

Server
  Name:         Demo 🚀
  Version:      4.2.2

Components
  Tools:        1
  Prompts:      1
  Resources:    1
  Templates:    1

先ほど追加したツール1件・プロンプト1件・静的リソース1件・テンプレート1件が、そのとおりカウントされていました。

この記事で確認できなかったこと

公式サイト(gofastmcp.com)は、このクラウド環境のネットワークポリシー上アクセスできませんでした。そのため、ドキュメントサイト上の表示や検索機能は確認できていません。また、今回試したのはSTDIO相当のインメモリ接続による最小構成のみで、fastmcp run --transport httpによる実際のHTTPサーバー起動、認証機能、OpenAPI/FastAPIからのサーバー自動生成、複数サーバーを合成する機能(README内で言及されている「サーバーの合成」)は、この記事では試していません。README内で紹介されている商用の「FastMCP Gateway」(Prefectが提供する、チーム向けにMCPサーバーを統括するための別プロダクト)についても、無料のOSS版フレームワークとは別物であり、本稿では一切検証していません。本稿はあくまで、公式リポジトリの記載とこのクラウド環境で実際に動かしたPython単体の最小構成の範囲での確認です。

向いている場面・まだ注意が必要な場面

  • 向いている:Claude CodeのようなMCP対応クライアントに、自分の書いたPython関数をツール・リソース・プロンプトとして渡したい場合。@mcp.tool・@mcp.resource・@mcp.promptというデコレータだけで、スキーマ生成やバリデーションをFastMCPに任せられる点は、今回の最小例でも実感できました
  • まだ注意が必要:FastMCP 1.0が公式MCP Python SDKに取り込まれた経緯があるぶん、「どこまでが標準のMCP Python SDKの機能で、どこからがFastMCP独自の拡張か」を意識して公式ドキュメントを読む必要があります。また本稿執筆時点のバージョンは4.2.2ですが、PyPIには2.x・3.x系の履歴も残っており、バージョン間でAPIが変わっている可能性があるため、本番導入時はピン留めしたバージョンのドキュメントを確認したほうが安全です

まとめ

FastMCPは、普通のPython関数に@mcp.tool・@mcp.resource・@mcp.promptというデコレータを付けるだけで、MCPサーバーのツール・リソース・プロンプトとして公開できるフレームワークです。このクラウド環境で実際にuv add fastmcpからインストールし、最小構成のサーバーを作って足し算ツールの呼び出し、静的・動的リソースの読み取り、プロンプトのメッセージ生成、fastmcp inspectによるコンポーネント一覧までを一通り確認できました。一方、HTTPサーバーとしての実運用や認証、OpenAPIからの自動生成といった機能はこの記事では検証していないため、本格的に使う場合は公式ドキュメント(gofastmcp.com)で該当する章を確認しながら進めるのが安全です。

参考にした一次情報

まずは、やりたいことを聞かせてください

「何から手をつければいいか分からない」段階でも大丈夫です。 ご相談・お見積りは無料。碧南近郊なら直接伺います。