MCP Demo

🚀 🤖 Claude互換MCPサーバーの設定ガイド

このガイドでは、Python、FastMCP、およびuvを使用して、WindowsとmacOS/LinuxでClaude互換のMCPサーバーを設定する方法を説明します。

✨ 主な機能

このガイドを通じて、Claude互換のMCPサーバーをWindowsとmacOS/Linux上で構築できます。Python、FastMCP、uvを利用し、簡単な手順でサーバーをセットアップできます。

🚀 クイックスタート

✅ 前提条件

• Python ≥ 3.12（mcp-exampleによって要求されます）
• uvがインストールされている
• ターミナル（コマンドプロンプト、PowerShell、またはBash）

📦 インストール

使用uv安装mcp包

ターミナルで以下のコマンドを実行します：

uv add "mcp[cli]"

Claudeのインストールは必須です

📁 ステップ1：MCPサーバーの作成（main.py）

プロジェクトフォルダ内にmain.pyという名前のファイルを作成します：

from mcp.server.fastmcp import FastMCP
import sys

print("✅ MCPサーバーの実行状況：", sys.version)

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

# 簡単なツールの追加
@mcp.tool()
def add(a: int, b: int) -> int:
    """2つの数字を足す"""
    return a + b

# 動的な挨拶リソースの追加
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """個別の挨拶を返す"""
    return f"こんにちは、{name}!"

📦 ステップ2：uvのインストール

🪟 Windows

1. PowerShellを管理者として開きます。
2. 以下のコマンドを実行します：

irm https://astral.sh/uv/install.ps1 | iex

これにより、uvが%USERPROFILE%\.cargo\bin\uvにインストールされます。

オプション： PATHに手動で追加する必要がある場合は、以下のコマンドを実行します：

$env:Path += ";$HOME\.cargo\bin"

その後、ターミナルを閉じて再開します。

🍎 macOS / 🐧 Linux

ターミナルで以下のコマンドを実行します：

curl -Ls https://astral.sh/uv/install.sh | sh

シェルの設定ファイルに追加する必要がある場合は、以下のコマンドを実行します：

export PATH="$HOME/.local/bin:$PATH"

テストを行います：

uv --version

✅ バージョン番号が表示されれば、インストールは成功です。

🚀 ステップ3：MCPサーバーの起動

Claude互換のサーバーを登録して起動します：

uv run mcp install main.py

このコマンドにより、以下のことが行われます：

• uvを使用してmcp[cli]が動的にインストールされます。
• main.pyサーバーが検証されます。
• Claudeで使用するために登録されます（統合されている場合）。

🧪 ステップ4（オプション）：手動テスト

正常に動作していることを確認するには、以下のコマンドを実行します：

uv run main.py

別のターミナルで、ツールとリソースをテストできます：

curl http://localhost:1234/_/add?tool=add\&a=1\&b=2
curl http://localhost:1234/_/greeting?resource=greeting%3A%2F%2Ftest

🔧 トラブルシューティング

エラーメッセージ：spawn uv ENOENT

• 原因： uvがインストールされていないか、正しく構成されていません。
• 解決策： uvインストールガイドに従って、uvを再インストールして構成します。

📝 その他の注意事項

• サーバーが実行中に適切な権限を持っていることを確認してください。
• MCPプロトコルの詳細を確認するには、MCPプロトコルドキュメントを参照してください。

追加リソース

• MCPサーバーをローカルで無料で実行する：GitHubサンプル
• MCPプロトコルについて詳しく読む：MCPプロトコル公式ドキュメント