Running Your MCP Server with FastMCP v2.0

FastMCP v2.0 で MCP サーバーを実行する

このガイドでは、FastMCP v2.0 を使って MCP サーバーを実行し、Claude Desktop で使用できるようにインストールする方法を説明します。

---

✅ 前提条件

以下を前提としています：

• 環境がすでにセットアップされていること
• サーバーコード（例：server.py）が完成しており、実行できる状態であること

---

🚀 サーバーの実行

1. FastMCP をインストールする（まだインストールしていない場合）

uv の使用をおすすめします：

uv pip install fastmcp

uv がない場合は、Homebrew を使ってインストールできます（macOS）：

brew install uv

または、pip を直接使用します：

pip install fastmcp

2. サーバーを実行する

FastMCP の実行コマンドを使用します：

fastmcp run server.py

スクリプトで標準のエントリーポイントを使用している場合：

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

その場合は、次のように実行することもできます：

python server.py

---

🛠️ Claude Desktop 用のサーバーのインストール

1. サーバーをインストールする

このコマンドで、Claude Desktop との連携に向けてサーバーを準備します：

fastmcp install server.py

2. Claude Desktop を再起動する

インストール後、Claude Desktop を再起動して、新しくインストールしたサーバーを読み込みます。

---

🔧 その他のヒント

依存関係を指定する

FastMCP のインスタンスを作成する際に、追加パッケージを宣言します：

mcp = FastMCP("My Server", dependencies=["pandas", "numpy"])

環境変数を設定する

インストール時に環境変数を渡します：

fastmcp install server.py -e API_KEY=your_api_key

.env ファイルを使用する

ファイルから環境設定を読み込みます：

fastmcp install server.py -f .env

---

✅ Claude プロンプトの例

add のようなツールを定義している場合は、Claude に次のように話しかけることができます：

「5 と 7 を足してください。」

Claude は MCP サーバーを使って計算結果を求めます。

---

詳しくは、こちらをご覧ください：https://github.com/jlowin/fastmcp

ℹ️ 注意：mcp-inspector のようなデバッグツールを使用する場合は、互換性を最適に保つために @modelcontextprotocol/[email protected] を使用してください。