文档 / reference

MCP 工具

公共与管理 MCP 服务器上的所有工具，含参数与示例。

服务器

服务器	URL	认证
Public	`https://jenksguo.xyz/mcp`	无
Admin	`https://jenksguo.xyz/mcp/admin`	`Authorization: Bearer <admin token>`
Local (stdio)	`jenks mcp` / `jenks mcp --admin`	管理使用环境变量 `JENKSGUO_ADMIN_TOKEN`

传输：可流式 HTTP、无状态、POST 上的 JSON-RPC 2.0（协议 2025-06-18）。对任一 URL 发起 GET 返回发现文档。服务器名 jenksguo，版本 1.1.0。

curl -s https://jenksguo.xyz/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_brief","arguments":{}}}'

公共工具

`get_brief` — 获取 Jenks 的简介

关于 Jenks Guo 的一页 Markdown 简介：定位、当前角色、职业轨迹、优势、语言、联系方式，以及如何进一步了解。从这里开始。

MCP: get_brief on https://jenksguo.xyz/mcp
REST: GET /api/v1/brief
CLI: jenks brief

无参数。

curl -s "https://jenksguo.xyz/api/v1/brief"

`list_experience` — 列出经历

列出 Jenks 的经历、项目、社区角色与教育（新到旧），可按行业标签、角色视角或类别筛选。返回简要信息：标题、机构、时间段、摘要、关键成果、页面 URL。

MCP: list_experience on https://jenksguo.xyz/mcp
REST: GET /api/v1/entries?tag=&lens=&kind=&locale=
CLI: jenks list [--tag it] [--lens solution-architect] [--kind project]

参数	类型	必填	说明
`tag`	`it` · `engineering` · `ai` · `devrel` · `web3` · `business` · `marketing` · `consulting` · `hospitality` · `community` · `creative`	否
`lens`	`head-of-ai` · `ai-transformation-consultant` · `engineering-manager` · `solution-architect` · `system-integrator` · `support-engineer` · `ict-specialist` · `developer-advocate` · `developer-evangelist` · `digital-marketer` · `hospitality`	否
`kind`	`experience` · `education` · `community` · `project`	否
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.xyz/api/v1/entries"

`get_entry` — 获取单条条目

按 slug 获取某条经历、项目、社区角色或教育条目的完整长文：概览、Jenks 的工作内容、成就、对雇主的价值、关键结果、技能、证明链接。

MCP: get_entry on https://jenksguo.xyz/mcp
REST: GET /api/v1/entries/{slug}?locale=
CLI: jenks get <slug>

参数	类型	必填	说明
`slug`	string	是	条目 slug，例如 xero-developer-evangelist
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.xyz/api/v1/entries/xero-developer-evangelist"

`list_lenses` — 列出角色视角

雇主可据此审视 Jenks 的角色视角（Head of AI、解决方案架构师、开发者倡导者、数字营销、餐饮业等），含电梯陈述、真实差距与证据数量。

MCP: list_lenses on https://jenksguo.xyz/mcp
REST: GET /api/v1/lenses?locale=
CLI: jenks lenses

参数	类型	必填	说明
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.xyz/api/v1/lenses"

`search_jenks` — 全文搜索

对所有条目与文档的关键词搜索。返回匹配度最高的片段及其 slug。

MCP: search_jenks on https://jenksguo.xyz/mcp
REST: GET /api/v1/search?q=
CLI: jenks search "<query>"

参数	类型	必填	说明
`query`	string	是

curl -s "https://jenksguo.xyz/api/v1/search"

`get_document` — 获取参考文档

Jenks 的参考文档之一：profile（核心档案）、credentials（教育与认证）、capabilities（能力→证据映射）、talks（演讲、播客、写作）、thinking（世界观）。

MCP: get_document on https://jenksguo.xyz/mcp
REST: GET /api/v1/documents/{name}?locale=
CLI: jenks doc <name>

参数	类型	必填	说明
`name`	`profile` · `credentials` · `capabilities` · `talks` · `thinking`	是
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.xyz/api/v1/documents/credentials"

`ask_jenks` — 向 Jenks 的助手提问

以自然语言向 Ask Jenks 助手提问（角色匹配、咨询范围界定、AI 转型建议、STAR 故事、治理等）。它会对语料运行自身工具，并以所需语言答复。有速率限制。

MCP: ask_jenks on https://jenksguo.xyz/mcp
REST: POST /api/v1/ask
CLI: jenks ask "<question>"

参数	类型	必填	说明
`question`	string	是
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	否	翻译字段的语言（默认 en）。
`history`	array	否	可选的更早对话轮次。

curl -s -X POST https://jenksguo.xyz/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question":"Is Jenks a fit for a Head of AI role?"}'

管理工具

`admin_schema` — 内容架构

内容模型：条目字段与规则、标签、视角、类别、可写路径、文档，以及编辑约定。写入前请阅读。

MCP: admin_schema on https://jenksguo.xyz/mcp/admin
REST: GET /api/admin/schema (admin token)
CLI: jenks admin schema

无参数。

curl -s "https://jenksguo.xyz/api/admin/schema" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_list_files` — 列出内容文件

列出某分支上的可编辑内容文件（路径、大小、sha），可选限定某文件夹，如 content/corpus/experiences。

MCP: admin_list_files on https://jenksguo.xyz/mcp/admin
REST: GET /api/admin/files?dir=&branch= (admin token)
CLI: jenks admin ls [dir]

参数	类型	必填	说明
`dir`	string	否	例如 content/corpus/projects（默认：全部内容）
`branch`	`main` · `dev`	否	main 发布到 jenksguo.xyz；dev 预览在 dev.jenksguo.xyz（默认 main）。

curl -s "https://jenksguo.xyz/api/admin/files" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_read_file` — 读取内容文件

读取某内容文件的原始 Markdown/JSON 源（含其 sha）。传入 path，或为条目、视角或技能传入 slug。

MCP: admin_read_file on https://jenksguo.xyz/mcp/admin
REST: GET /api/admin/file?path=&slug=&branch= (admin token)
CLI: jenks admin get <slug|path>

参数	类型	必填	说明
`path`	string	否
`slug`	string	否
`branch`	`main` · `dev`	否	main 发布到 jenksguo.xyz；dev 预览在 dev.jenksguo.xyz（默认 main）。

curl -s "https://jenksguo.xyz/api/admin/file" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_validate` — 验证变更

在不提交的情况下，将文件内容与内容架构进行校验。返回问题列表（空列表表示有效）。

MCP: admin_validate on https://jenksguo.xyz/mcp/admin
REST: POST /api/admin/validate (admin token)
CLI: jenks admin validate <path> <file>

参数	类型	必填	说明
`path`	string	是
`content`	string	是

curl -s -X POST https://jenksguo.xyz/api/admin/validate \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path":"content/corpus/projects/example.md","content":"<content>"}'

`admin_write_file` — 创建或更新内容文件

校验并提交单个内容文件（创建或替换）。发布自动进行：CI 会将变更的条目重新翻译为所有语言，重建并部署（main → jenksguo.xyz，dev → dev.jenksguo.xyz），耗时数分钟。

MCP: admin_write_file on https://jenksguo.xyz/mcp/admin
REST: PUT /api/admin/file (admin token)
CLI: jenks admin put <path> <file> -m <message>

参数	类型	必填	说明
`path`	string	是
`content`	string	是
`message`	string	是	提交信息
`branch`	`main` · `dev`	否	main 发布到 jenksguo.xyz；dev 预览在 dev.jenksguo.xyz（默认 main）。

curl -s -X PUT https://jenksguo.xyz/api/admin/file \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path":"content/corpus/projects/example.md","content":"<content>","message":"<message>"}'

`admin_delete_file` — 删除内容文件

删除单个内容文件（例如移除一条条目），并附带提交信息。Git 历史可用于恢复。

MCP: admin_delete_file on https://jenksguo.xyz/mcp/admin
REST: DELETE /api/admin/file?path=&message=&branch= (admin token)
CLI: jenks admin rm <path> -m <message>

参数	类型	必填	说明
`path`	string	是
`message`	string	是
`branch`	`main` · `dev`	否	main 发布到 jenksguo.xyz；dev 预览在 dev.jenksguo.xyz（默认 main）。

curl -s -X DELETE https://jenksguo.xyz/api/admin/file \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path":"content/corpus/projects/example.md","message":"<message>"}'

`admin_commit_changes` — 批量提交

一次性校验并提交多文件变更为一个提交。每个变更为 {path, content} 或 {path, delete: true}。

MCP: admin_commit_changes on https://jenksguo.xyz/mcp/admin
REST: POST /api/admin/changes (admin token)
CLI: jenks admin commit <changes.json> -m <message>

参数	类型	必填	说明
`changes`	array	是
`message`	string	是
`branch`	`main` · `dev`	否	main 发布到 jenksguo.xyz；dev 预览在 dev.jenksguo.xyz（默认 main）。

curl -s -X POST https://jenksguo.xyz/api/admin/changes \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"changes":"<changes>","message":"<message>"}'

`admin_ai_edit` — 用 AI 起草编辑

请站点模型根据一条英文指令改写单个内容文件。返回建议内容、diff 与校验问题。不提交——请审阅后再调用 admin_write_file。

MCP: admin_ai_edit on https://jenksguo.xyz/mcp/admin
REST: POST /api/admin/ai-edit (admin token)
CLI: jenks admin ai-edit <slug|path> "<instruction>" [--apply]

参数	类型	必填	说明
`path`	string	否
`slug`	string	否
`instruction`	string	是
`branch`	`main` · `dev`	否	main 发布到 jenksguo.xyz；dev 预览在 dev.jenksguo.xyz（默认 main）。
`content`	string	否	可选：基于未保存的文件文本起草（默认：已保存文件）。

curl -s -X POST https://jenksguo.xyz/api/admin/ai-edit \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"instruction":"<instruction>"}'

`admin_deploy_status` — 部署状态

最近的 CI 运行（翻译 → 构建 → 部署），包含状态、分支、提交与链接。

MCP: admin_deploy_status on https://jenksguo.xyz/mcp/admin
REST: GET /api/admin/deploys?branch= (admin token)
CLI: jenks admin deploys

参数	类型	必填	说明
`branch`	`main` · `dev`	否	main 发布到 jenksguo.xyz；dev 预览在 dev.jenksguo.xyz（默认 main）。

curl -s "https://jenksguo.xyz/api/admin/deploys" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_promote` — 将 dev 提升到生产

将 dev 分支合并到 main，把 dev.jenksguo.xyz 上预览的一切发布到 jenksguo.xyz。

MCP: admin_promote on https://jenksguo.xyz/mcp/admin
REST: POST /api/admin/promote (admin token)
CLI: jenks admin promote

参数	类型	必填	说明
`message`	string	否

curl -s -X POST https://jenksguo.xyz/api/admin/promote \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{}'

.md本页内容在 AI 协助下翻译；官方职位名称保留英文。

MCP 工具

服务器

公共工具

get_brief — 获取 Jenks 的简介

list_experience — 列出经历

get_entry — 获取单条条目

list_lenses — 列出角色视角

search_jenks — 全文搜索

get_document — 获取参考文档

ask_jenks — 向 Jenks 的助手提问

管理工具

admin_schema — 内容架构

admin_list_files — 列出内容文件

admin_read_file — 读取内容文件

admin_validate — 验证变更

admin_write_file — 创建或更新内容文件

admin_delete_file — 删除内容文件

admin_commit_changes — 批量提交

admin_ai_edit — 用 AI 起草编辑

admin_deploy_status — 部署状态

admin_promote — 将 dev 提升到生产