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

已驗證STDIO僅桌面檔案與儲存知識與記憶

概覽

AI 產生的概覽

一個提供 Francisco Perez-Sorrosal 履歷的 MCP 伺服器,以結構化 JSON 資源形式讓助理讀取並查詢其履歷條目。

可以做什麼
讀取完整履歷的 JSON 資源,包含履歷資料與語意資料。依條目查詢工作經歷、教育背景、技能、著作與專利等資訊。
適用情境
適合需要助理回答關於此人職涯背景的問題,或在對話中引用其履歷資料的情境。
執行需求
以桌面安裝包形式在使用者機器上作為本機程序執行;README 另列出遠端 MCP 端點。未宣告帳號、金鑰或環境變數。需要網路存取以取得最新發布資料。
安裝前請注意
伺服器會自動從遠端發布取得履歷資料,內容來自第三方。README 描述了編輯與發布流程,會推送分支、建立拉取請求與發布標籤;這些操作會改動儲存庫並使用 GitHub 驗證,執行任何寫入操作前請先確認。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Cv,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 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 from cv-forge
  • .github/workflows/ — CI validation and tag-triggered publishing

Making changes

To propose an edit to the CV data:

  1. Clone this repo and create a branch: git switch -c update/your-change
  2. Edit cv-data/resume.yaml or cv-data/resume-semantics.yaml
  3. Validate locally (see below)
  4. Push and open a PR against main

The CI workflow validates automatically; if checks pass, merge and proceed to Publishing.

Validate before you PR

bash
# Install check-jsonschema (standalone CLI)pip install check-jsonschema
# Validate both filescheck-jsonschema --schemafile schemas/resume.schema.json cv-data/resume.yamlcheck-jsonschema --schemafile schemas/semantics.schema.json cv-data/resume-semantics.yaml

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).

bash
git tag 2026.09.13git push origin 2026.09.13

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.json manifest (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):

bash
gh workflow run publish.yml -f tag=2026.09.14

Or via the GitHub Actions UI:

  1. Open Actions → Publish CV
  2. Click "Run workflow"
  3. Enter the tag in the tag input
  4. 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:

  1. After cv-forge merges a PR that changes src/cv_forge/models/, refresh the mirrored copies:

    bash
    curl -s https://raw.githubusercontent.com/francisco-perez-sorrosal/cv-forge/v1/schemas/resume.schema.json > schemas/resume.schema.jsoncurl -s https://raw.githubusercontent.com/francisco-perez-sorrosal/cv-forge/v1/schemas/semantics.schema.json > schemas/semantics.schema.jsongit add schemas/git commit -m "chore: sync schemas from cv-forge v1"git push
  2. The CI drift-check (.github/workflows/validate.yml) compares the local schemas against the remote cv-forge v1 copies. If they diverge, the check fails and blocks PRs until the sync above completes. A push that lands seconds before cv-forge re-points its v1 tag can fail the drift check with a 404 on the upstream fetch; re-run the failed Validate CV Data job once the tag exists.

Consuming the CV

As data

  • YAML sources: resume.yaml and resume-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:

text
MCP Server: https://fps-cv-mcp.wasmer.app/mcp

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:

  1. Launch from Claude Code: "Update my CV" or "Add this job"
  2. Edit the YAML directly in the conversation
  3. Validate automatically against the schema
  4. Preview the rendered output
  5. 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 (cv consumer, cv-forge maintainer).

來源:README.md,提交 d43de6c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.0.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分