
Cv
io.github.francisco-perez-sorrosalPublished by GitHub account francisco-perez-sorrosalv0.0.3Updated Oct 24, 2026
An MCP server that provides access to Francisco Perez-Sorrosal's CV
Overview
An MCP server that serves Francisco Perez-Sorrosal's CV as structured JSON resources, letting an assistant read and look up his resume entries.
- What you can do
- Read the full CV as JSON resources for resume and semantics data, plus per-entry lookups of experience, education, skills, publications and patents.
- When to use it
- Useful when you want an assistant to answer questions about this specific person's professional background, or to reference his CV data in a conversation.
- Requirements
- Runs as a local process on the user's machine via a desktop package; the README also lists a remote MCP endpoint. No accounts, keys or environment variables are declared. Network access is needed to fetch the latest release data.
Installation
In SourceWeft
- Open Cv in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
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).
Source: README.md at commit d43de6c
Tools
0Version history
1- v0.0.3LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts