Cervo

공유 VPS에서 정적 웹사이트 호스팅을 관리하기 위한 데모 앱입니다. MCP 서버(FastMCP, HTTP로 제공)로 구축되어 있어, AI와의 채팅으로 호스팅을 관리합니다. 개발 중에는 Claude Code가 채팅 인터페이스 역할을 하여 서버의 도구를 실행하고 테스트합니다.

빠른 시작

전제 조건: uv 및 Docker(Compose 포함).

uv sync                 # install deps
docker compose up -d    # supporting services (caddy, mailcatcher)
uv run cervo            # start the MCP server at http://127.0.0.1:8000/mcp

그런 다음 이 저장소에서 Claude Code를 엽니다. 서버가 .mcp.json에 미리 등록되어 있으므로 도구가 채팅에서 바로 사용할 수 있습니다. Claude Code 세션을 열기 전에 MCP 서버를 시작하고(연결은 시작 시 이루어짐), MCP 서버 코드를 변경할 때마다 /mcp를 실행하여 다시 연결하세요. Claude Code는 자동으로 다시 연결되지 않습니다.

개발은 별도의 구성 없이 작동합니다. 설정은 .env 파일을 통해 재정의할 수 있습니다(구성 표 참조).

Related MCP server: StaticX MCP Server

문서

자세한 정보는 CLAUDE.md에 있습니다(Claude Code가 프로젝트 컨텍스트로도 로드함).

• 구성 — 모든 설정 및 기본값

• 레이아웃 — 코드베이스에서 각 요소의 위치

• Claude Code로 테스트 — 개발/테스트 워크플로우