EAG v3 — Demo de MCP con interfaz Prefab

Un servidor FastMCP con tres herramientas que utilizan (1) internet, (2) CRUD de archivos locales y (3) interfaz generativa a través de Prefab. Diseñado para ejecutarse dentro de Claude Desktop.

Herramientas

Herramienta	Tipo	Propósito
`web_search(query)`	internet	API de respuesta instantánea de DuckDuckGo: devuelve resumen + temas relacionados
`notes_file(action, key, content)`	CRUD local	una herramienta, con acciones (`create` / `read` / `update` / `delete` / `list`) sobre `./notes.json`
`show_dashboard()`	UI	renderiza las notas guardadas como una cuadrícula de tarjetas Prefab (usa `@mcp.tool(app=True)`)

Configuración

Requiere uv (brew install uv) y Claude Desktop.

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

Conectar a Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json y añade (o fusiona) el bloque mcpServers:

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

Reinicia Claude Desktop. El indicador de MCP debería mostrar eag-mcp-demo con tres herramientas.

Alternativa con Python estándar (sin uv)

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

Luego, en la configuración de Claude Desktop, usa:

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

Prompt de demostración

Pega esto en Claude Desktop después de conectar el servidor:

Busca los detalles de propiedad de Tata Sons mediante búsqueda web, guarda un resumen de 2 a 3 frases en mi archivo de notas bajo la clave tata_sons, luego abre el panel de control para que pueda verlo.

Comportamiento esperado:

web_search("Tata Sons ownership") → Resumen de DDG.
notes_file("create", "tata_sons", "<resumen>") → escribe en notes.json.
show_dashboard() → renderiza una cuadrícula de tarjetas Prefab en línea con una tarjeta.

Vuelve a ejecutarlo con otra empresa (p. ej., "Reliance Industries") y el panel de control mostrará ahora dos tarjetas.

Prueba de humo

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

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

En el inspector: lista las herramientas, llama a web_search("Tata Sons"), luego llama a notes_file("create", "x", "y") y confirma que notes.json se actualiza en el disco.

Alternativas

El renderizador de Prefab no se activa (Claude Desktop devuelve JSON en lugar de UI): cambia el decorador show_dashboard de @mcp.tool(app=True) a @mcp.tool simple y haz que devuelva una tabla Markdown construida a partir de notes.json.
DuckDuckGo devuelve resultados vacíos para la consulta: DDG solo tiene respuestas instantáneas para entidades conocidas. Usa empresas, personas o lugares famosos para la demostración.

Archivos

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