EAG v3 — MCP-Demo mit Prefab UI

Ein FastMCP-Server mit drei Tools, die (1) das Internet, (2) lokales Datei-CRUD und (3) generatives UI über Prefab nutzen. Entwickelt für die Ausführung in Claude Desktop.

Tools

Tool	Typ	Zweck
`web_search(query)`	Internet	DuckDuckGo Instant Answer API — gibt Zusammenfassung + verwandte Themen zurück
`notes_file(action, key, content)`	lokales CRUD	ein Tool, aktionsgesteuert (`create` / `read` / `update` / `delete` / `list`) über `./notes.json`
`show_dashboard()`	UI	rendert gespeicherte Notizen als Prefab-Kartengitter (verwendet `@mcp.tool(app=True)`)

Einrichtung

Erfordert uv (brew install uv) und Claude Desktop.

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

In Claude Desktop einbinden

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json und fügen Sie den mcpServers-Block hinzu (oder führen Sie ihn zusammen):

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

Starten Sie Claude Desktop neu. Die MCP-Anzeige sollte eag-mcp-demo mit drei Tools anzeigen.

Plain-Python-Fallback (ohne uv)

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

Verwenden Sie dann in der Claude Desktop-Konfiguration:

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

Demo-Prompt

Fügen Sie dies in Claude Desktop ein, nachdem der Server eingebunden wurde:

Finde die Eigentümerdetails von Tata Sons über die Websuche, speichere eine 2–3-sätzige Zusammenfassung in meiner Notizdatei unter dem Schlüssel tata_sons und öffne dann das Dashboard, damit ich sie sehen kann.

Erwartetes Verhalten:

web_search("Tata Sons ownership") → DDG-Zusammenfassung.
notes_file("create", "tata_sons", "<summary>") → schreibt in notes.json.
show_dashboard() → rendert ein Prefab-Kartengitter inline mit einer Karte.

Führen Sie es erneut mit einem anderen Unternehmen aus (z. B. "Reliance Industries") und das Dashboard zeigt nun zwei Karten an.

Rauchtest

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

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

Im Inspektor: Tools auflisten, web_search("Tata Sons") aufrufen, dann notes_file("create", "x", "y") aufrufen und bestätigen, dass notes.json auf der Festplatte aktualisiert wird.

Fallbacks

Prefab-Renderer wird nicht aktiv (Claude Desktop gibt JSON statt UI zurück): Ändern Sie den show_dashboard-Decorator von @mcp.tool(app=True) zu einfachem @mcp.tool und lassen Sie ihn eine aus notes.json erstellte Markdown-Tabelle zurückgeben.
DuckDuckGo gibt für die Abfrage nichts zurück: DDG bietet nur Instant Answers für bekannte Entitäten. Verwenden Sie für die Demo berühmte Unternehmen / Personen / Orte.

Dateien

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