
Cv
io.github.francisco-perez-sorrosal由 GitHub 帳號 francisco-perez-sorrosal 發布v0.0.3更新於 Oct 24, 2026
An MCP server that provides access to Francisco Perez-Sorrosal's CV
概覽
一個提供 Francisco Perez-Sorrosal 履歷的 MCP 伺服器,以結構化 JSON 資源形式讓助理讀取並查詢其履歷條目。
- 可以做什麼
- 讀取完整履歷的 JSON 資源,包含履歷資料與語意資料。依條目查詢工作經歷、教育背景、技能、著作與專利等資訊。
- 適用情境
- 適合需要助理回答關於此人職涯背景的問題,或在對話中引用其履歷資料的情境。
- 執行需求
- 以桌面安裝包形式在使用者機器上作為本機程序執行;README 另列出遠端 MCP 端點。未宣告帳號、金鑰或環境變數。需要網路存取以取得最新發布資料。
安裝
README
CV Data Repository
The single source of truth for Francisco Perez-Sorrosal's CV content. YAML data, validation schema, and publishing workflow. Rendered artifacts (PDF, HTML, LaTeX, Typst, Markdown) are generated and released via GitHub Releases, never committed here.
What's here
cv-data/resume.yaml— structured CV content (experience, education, skills, publications, patents, etc.)cv-data/resume-semantics.yaml— semantic overlay (topics, relationships, annotations)schemas/— JSON Schema for validation; mirrored fromcv-forge.github/workflows/— CI validation and tag-triggered publishing
Making changes
To propose an edit to the CV data:
- Clone this repo and create a branch:
git switch -c update/your-change - Edit
cv-data/resume.yamlorcv-data/resume-semantics.yaml - Validate locally (see below)
- Push and open a PR against
main
The CI workflow validates automatically; if checks pass, merge and proceed to Publishing.
Validate before you PR
All green? Ready to PR.
Publishing a release
A release is triggered by pushing a CalVer tag in the form YYYY.MM.DD (with optional .N for same-day re-releases, e.g. 2026.09.13.1).
The workflow automatically:
- Renders the CV in all formats (PDF, LaTeX, Typst, Markdown, HTML)
- Publishes eight assets to the GitHub Release
- Deploys the HTML to the live CV site
- Creates a
release.jsonmanifest (consumed by the MCP server)
All assets are stable, version-free URLs under releases/latest/download/<name>.
Republish an Existing Release
To re-run the publish workflow without creating a new tag (useful when templates or rendering logic changes):
Or via the GitHub Actions UI:
- Open Actions → Publish CV
- Click "Run workflow"
- Enter the tag in the
taginput - Click "Run workflow"
This regenerates all eight release assets and redeploys the site, keeping the same version number. Assets at releases/latest/download/ are updated in place (overwritten).
Schema Updates
The JSON schemas in schemas/ are mirrored from cv-forge. When cv-forge releases a new version that changes the data models (via export-schemas), update the schemas in this repo:
-
After cv-forge merges a PR that changes
src/cv_forge/models/, refresh the mirrored copies: -
The CI drift-check (
.github/workflows/validate.yml) compares the local schemas against the remotecv-forge v1copies. If they diverge, the check fails and blocks PRs until the sync above completes. A push that lands seconds beforecv-forgere-points itsv1tag can fail the drift check with a 404 on the upstream fetch; re-run the failedValidate CV Datajob once the tag exists.
Consuming the CV
As data
- YAML sources:
resume.yamlandresume-semantics.yaml, published as release assets (see the URL pattern below) - JSON: the MCP server exposes the same data as JSON resources (
fps-cv://resume,fps-cv://semantics) and per-entry lookups
As documents
- PDF:
FranciscoPerezSorrosal_CV.pdf - HTML (interactive):
FranciscoPerezSorrosal_CV.html, also served at the live CV site - LaTeX (moderncv):
FranciscoPerezSorrosal_CV.tex - Typst (moderner-cv):
FranciscoPerezSorrosal_CV.typ - Markdown:
FranciscoPerezSorrosal_CV.md
All at https://github.com/francisco-perez-sorrosal/cv/releases/latest/download/<filename>.
Via MCP
The cv Claude Code plugin connects to an MCP server that serves the CV:
The server fetches the latest release data automatically; no deploy required when you publish.
Data conventions
See CLAUDE.md for entry ID scheme, cross-reference rules, date format, and validation commands.
Editing with the plugin
The cv-forge maintainer plugin provides an interactive edit flow:
- Launch from Claude Code: "Update my CV" or "Add this job"
- Edit the YAML directly in the conversation
- Validate automatically against the schema
- Preview the rendered output
- Diff and confirm before opening a PR
No manual YAML editing or command-line work required. The plugin uses your gh auth for the PR.
Related repositories
cv-forge— machinery that renders, serves, and publishes this data. Contains the CLI, MCP server, and the two Claude Code plugins (cvconsumer,cv-forgemaintainer).
來源:README.md,提交 d43de6c
工具
0版本歷史
1- v0.0.3最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分