MCP Server Demo Kat

🚀 MCP サーバーデモガイド

本ガイドは、簡単なモデルコンテキストプロトコル (MCP) サーバーを作成し、MCP チェッカーと Claude Desktop を使用してテストする方法を紹介します。

🚀 クイックスタート

前提条件

• uv - Rust で書かれた超高速な Python パッケージとプロジェクトマネージャーです。

MCP サーバーを作成する手順

1. 環境設定

uv init mcp-server-demo
cd mcp-server-demo

# Python バージョンを指定
echo "3.12" > .python-version

# Python をインストールする前に新しい仮想環境を作成
uv venv 

# 仮想環境をアクティブ化
source .venv/bin/activate.fish

# Python 環境を検証（正しい Python 環境を使用しているか確認）
which python
path/to/mcp-server-demo/.venv/bin/python

# MCP 依存関係をインストール（pyproject.toml に追加）
uv add "mcp[cli]"

# MCP 依存関係が正しくインストールされていることを検証
uv tree

Resolved 28 packages in 3ms
mcp-server-demo v0.1.0
└── mcp[cli] v1.6.0
    ├── ...

2. シンプルな MCP サーバーを作成

# server.py
from mcp.server.fastmcp import FastMCP

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

# 加法ツールを追加
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# 動的な挨拶リソースを追加
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

3. MCP チェッカーを使用してテスト

MCP チェッカーを起動

uv run mcp dev server.py

MCP チェッカーを起動中...
⚙️  代理サーバーがポート 6277 でリッスンしています

add ツールをテスト

1. MCP チェッカーを開きます。
2. "Connect" をクリックします。
3. "Tools" タブをクリックします。
4. "Tools" タブ内で "List Tools" をクリックします。

get_greeting リソースをテスト

1. MCP チェッカーを開きます。
2. "Connect" をクリックします。
3. "Resources" タブをクリックします。
4. "List Templates" をクリックします。
5. "get_greeting" を見つけます。
6. 名前（例："John"）を入力します。
7. "Read Resources" をクリックします。

例の応答：

{
  "contents": [
    {
      "uri": "greeting://John",
      "mimeType": "text/plain",
      "text": "Hello, John!"
    }
  ]
}

4. Claude Desktop を使用してテスト

Claude Desktop で MCP サーバーをインストール

uv run mcp install server.py

[/dd/MM/YY HH:MM:SS] INFO     Added server 'Demo' to Claude config            claude.py:129
                     INFO     Successfully installed Demo in Claude app          cli.py:467

設定を検証

# macOS/Linux の場合
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

例の設定：

{
  "servers": [
    {
      "name": "Demo",
      "url": "http://localhost:5000"
    }
  ]
}

MCP サーバーを使用する

1. MCP サーバーを起動します（例：python server.py を実行）。
2. Claude Desktop を開きます。
3. Claude で質問を入力します。例：
   • "What is 5 plus 3?"
   • "今天是几月？"

Claude Desktop は MCP サーバーが提供するツールを使用してこれらの質問に回答します。

❓ よくある質問

MCP サーバーにカスタムツールを追加するには？

• server.py で新しいツールを定義し、@mcp.tool() デコレータを使用します。
• 例：

@mcp.tool()
def greet(name: str) -> str:
    """Greet someone"""
    return f"Hello, {name}!"

複数の MCP サーバーから選択するには？

• 設定ファイルで優先順位を指定します。
• 例：

{
  "servers": [
    {
      "name": "Primary",
      "url": "http://primary-server:5000"
    },
    {
      "name": "Secondary",
      "url": "http://secondary-server:5000"
    }
  ]
}

📚 参考資料

• モデルコンテキストプロトコル > LLMs を使用した MCP の構築
• モデルコンテキストプロトコル > デバッグ
• モデルコンテキストプロトコル > チェッカー