CV REST/MCP Server

FastAPI + FastMCPサービスで、CVをJSONまたはテーマ付きPDFとしてレンダリングします。

実行

just setup && just dev

サーバー: http://localhost:8080 · MCP: /mcp (JSON-RPC、ブラウザページではありません)

Related MCP server: cv-builder

REST API

対話型OpenAPIドキュメント（Swagger UI）: /docs

MCP

Streamable HTTPトランスポートを介して/mcpにマウントされています。

ツール

MCPクライアントから接続

MCP互換のクライアント（Claude Desktop、Cursor、Kiloを搭載したVS Code、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対応）