EAG v3 — MCP-демо с интерфейсом Prefab

Сервер FastMCP с тремя инструментами, которые задействуют (1) интернет, (2) локальный CRUD файлов и (3) генеративный интерфейс через Prefab. Предназначен для работы внутри 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 с тремя инструментами.

Вариант на чистом 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 после подключения сервера:

Найди информацию о владельцах 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() → отрисовка сетки карточек Prefab с одной карточкой.

Запустите снова с другой компанией (например, "Reliance Industries"), и на панели управления появятся две карточки.

Дымовое тестирование

# 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 возвращает JSON вместо UI): измените декоратор show_dashboard с @mcp.tool(app=True) на обычный @mcp.tool и сделайте так, чтобы он возвращал Markdown-таблицу, построенную на основе notes.json.

• DuckDuckGo возвращает пустой результат для запроса: у DDG есть мгновенные ответы только для известных сущностей. Используйте известные компании / людей / места для демонстрации.

Файлы

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