EAG v3 — Prefab UI を備えた MCP デモ

(1) インターネット、(2) ローカルファイルのCRUD、(3) Prefab を介した生成UI、という3つのツールを備えた FastMCP サーバーです。Claude Desktop 内で実行するように設計されています。

ツール

セットアップ

uv (brew install uv) と Claude Desktop が必要です。

cd /Users/nitingangwar/Documents/Code/eagv3/mcp
uv sync

Claude Desktop への接続

~/Library/Application Support/Claude/claude_desktop_config.json を編集し、mcpServers ブロックを追加（またはマージ）します：

{
  "mcpServers": {
    "eag-mcp-demo": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "run",
        "--directory",
        "/Users/nitingangwar/Documents/Code/eagv3/mcp",
        "python",
        "server.py"
      ]
    }
  }
}

Claude Desktop を再起動します。MCP インジケーターに eag-mcp-demo と3つのツールが表示されるはずです。

Python 単体でのフォールバック（uv なし）

python3 -m venv .venv
.venv/bin/pip install -e .

その後、Claude Desktop の設定で以下を使用します：

"command": "/Users/nitingangwar/Documents/Code/eagv3/mcp/.venv/bin/python",
"args": ["/Users/nitingangwar/Documents/Code/eagv3/mcp/server.py"]

デモ用プロンプト

サーバーを接続した後、Claude Desktop に以下を貼り付けてください：

Web検索で Tata Sons の所有権の詳細を調べ、2〜3文の要約を tata_sons というキーでノートファイルに保存し、ダッシュボードを開いて確認できるようにしてください。

期待される動作：

1. web_search("Tata Sons ownership") → DDG の概要を取得。

2. notes_file("create", "tata_sons", "<summary>") → notes.json に書き込み。

3. show_dashboard() → 1枚のカードを含む Prefab カードグリッドをインラインでレンダリング。

別の企業（例：「Reliance Industries」）で再実行すると、ダッシュボードに2枚のカードが表示されます。

スモークテスト

# Server starts and blocks on stdin (correct):
uv run python server.py

# Or interactive inspector:
npx @modelcontextprotocol/inspector uv run python server.py

インスペクターで、ツールをリストアップし、web_search("Tata Sons") を呼び出し、次に notes_file("create", "x", "y") を呼び出して、ディスク上の notes.json が更新されることを確認します。

フォールバック

• Prefab レンダラーが動作しない場合（Claude Desktop が UI ではなく JSON を返す）：show_dashboard デコレーターを @mcp.tool(app=True) から通常の @mcp.tool に変更し、notes.json から構築された Markdown テーブルを返すようにします。

• DuckDuckGo がクエリに対して空の結果を返す場合：DDG は有名なエンティティに対してのみ Instant Answer を持っています。デモには有名な企業、人物、場所を使用してください。

ファイル

server.py        # FastMCP server with the 3 tools
notes.json       # backing store for notes_file (starts as {})
pyproject.toml   # deps: fastmcp[apps], prefab-ui==0.19.1, httpx