EAG v3 — Prefab UI를 포함한 MCP 데모

(1) 인터넷, (2) 로컬 파일 CRUD, (3) Prefab을 통한 생성형 UI를 활용하는 세 가지 도구가 포함된 FastMCP 서버입니다. Claude Desktop 내에서 실행되도록 설계되었습니다.

도구

도구	유형	목적
`web_search(query)`	인터넷	DuckDuckGo Instant Answer API — 요약 및 관련 주제 반환
`notes_file(action, key, content)`	로컬 CRUD	단일 도구, `./notes.json`에 대해 액션 디스패치(`create` / `read` / `update` / `delete` / `list`) 수행
`show_dashboard()`	UI	저장된 노트를 Prefab 카드 그리드로 렌더링 (`@mcp.tool(app=True)` 사용)

설정

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라는 키로 내 노트 파일에 저장한 다음, 대시보드를 열어 확인할 수 있게 해줘.

예상 동작:

web_search("Tata Sons ownership") → DDG 요약.
notes_file("create", "tata_sons", "<summary>") → notes.json에 기록.
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이 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