CV REST/MCP 서버

FastAPI + FastMCP 서비스로, CV를 JSON 또는 테마가 적용된 PDF로 렌더링합니다.

실행

just setup && just dev

서버: http://localhost:8080 · MCP: /mcp (JSON-RPC, 브라우저 페이지가 아님)

Related MCP server: MCP-Server

REST API

대화형 OpenAPI 문서 (Swagger UI): /docs

MCP

Streamable HTTP 전송을 통해 /mcp에 마운트됩니다.

도구

MCP 클라이언트에서 연결

MCP 호환 클라이언트(Claude Desktop, Cursor, VS Code with Kilo, Windsurf)는 모두 이 서버를 사용할 수 있습니다. 클라이언트의 MCP 구성에 추가하세요:

{
  "mcpServers": {
    "cv-rest-mcp-server": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

배포된 인스턴스의 경우 URL을 공개 엔드포인트로 교체하세요.

테마

classic · minimal · modern · original — app/themes/<name>.py에 CSS 문자열로 정의되어 있습니다.

콘텐츠 및 사용자 지정

data/cv.json을 편집하세요(app/cv_data.py의 CVData에 대해 검증됨). 변경 후 다시 시작하세요.

CV_DATA_PATH를 설정하여 다른 JSON 파일을 가리키게 할 수 있습니다. 전체 스키마는 data/cv.example.json을 참조하세요.

속도 제한

IP별, 인메모리 방식입니다. localhost는 제외됩니다.

Docker

just build && just run

GCP 배포

main에 푸시하면 CI가 실행되고, 품질 및 테스트 작업이 모두 통과한 후 Cloud Run에 자동으로 배포됩니다. 배포 없이 CI만 실행하려면 커밋 메시지에 [skip deploy]를 추가하세요. GitHub 기본 제공 [skip ci], [ci skip], [no ci], [skip actions], [actions skip]은 워크플로 전체를 건너뛰므로 필수 검사가 보류 상태로 남을 수 있습니다.

일회성 운영자 설정은 배포 스크립트를 사용합니다(멱등적; .env의 SVC_NAME은 서비스, 이미지 및 파생 서비스 계정의 이름을 지정합니다):

just deploy bootstrap                                  # first full run
just deploy upload-cv                                   # publish personal CV data
just deploy wif                                        # one-time GitHub OIDC wiring

일반적인 코드 릴리스의 경우 main에 정상 변경 사항을 푸시하세요. 빌드/배포/검증 단계를 수동으로 실행하지 마세요. CD 검증 작업은 배포된 URL을 출력합니다. Google Cloud Console의 Cloud Run → 서비스 → URL에서도 확인할 수 있습니다. CLI 조회는 현재 SVC_NAME과 GCP_REGION을 사용합니다. 서비스 계정 ID는 URL의 일부가 아닙니다.

기술 스택

FastAPI · FastMCP v3 · WeasyPrint · Jinja2 · Cloud Run 호환(무상태, $PORT 인식)