src/demo_mcp/
├── server.py          # FastMCP 인스턴스 + lifespan + 등록 진입점
├── config.py          # 설정/시드 데이터
├── tools/             # @mcp.tool
│   ├── echo.py
│   ├── calculator.py
│   └── notes.py       # lifespan context 예시
├── resources/         # @mcp.resource
│   ├── config.py
│   └── notes.py
└── prompts/           # @mcp.prompt
    └── assistant.py
tests/
└── test_server.py     # Client(mcp) 인메모리 테스트

uv sync --extra dev

uv run pytest -q

uv run demo-mcp

DEMO_MCP_TRANSPORT=stdio uv run demo-mcp

{
  "mcpServers": {
    "demo-mcp": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}