文件 / reference

MCP 工具

公共與管理 MCP 伺服器上的所有工具、參數與範例。

伺服器

伺服器	URL	驗證
公共	`https://jenksguo.xyz/mcp`	無
管理	`https://jenksguo.xyz/mcp/admin`	`Authorization: Bearer <admin token>`
本機 (stdio)	`jenks mcp` / `jenks mcp --admin`	環境變數 `JENKSGUO_ADMIN_TOKEN`（用於管理）

傳輸：可串流 HTTP、無狀態、JSON-RPC 2.0（以 POST；協定 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 的簡介

一頁式 Markdown 簡介，涵蓋 Jenks Guo 的定位、目前職務、職涯軌跡、強項、語言、聯絡方式，以及如何進一步探索。從這裡開始。

MCP： 在 https://jenksguo.xyz/mcp 使用 get_brief
REST： GET /api/v1/brief
CLI： jenks brief

無參數。

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

`list_experience` — 列出經歷

列出 Jenks 的經歷、專案、社群角色與教育（最新優先），可選擇依產業標籤、角色視角或類型篩選。回傳精簡格式：標題、組織、期間、摘要、關鍵成果、頁面 URL。

MCP： 在 https://jenksguo.xyz/mcp 使用 list_experience
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： 在 https://jenksguo.xyz/mcp 使用 get_entry
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、solution architect、developer advocate、digital marketer、hospitality…），包含推介、真實差距與證據數量。

MCP： 在 https://jenksguo.xyz/mcp 使用 list_lenses
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： 在 https://jenksguo.xyz/mcp 使用 search_jenks
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（演講、Podcast、寫作）、thinking（世界觀）。

MCP： 在 https://jenksguo.xyz/mcp 使用 get_document
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` — 詢問 Ask Jenks 助理

以自然語言向 Ask Jenks 助理提問（角色適配、顧問範疇界定、AI 轉型建議、STAR 故事、治理…）。它會在全文庫上運行自身工具，並以請求的語言作答。有速率限制。

MCP： 在 https://jenksguo.xyz/mcp 使用 ask_jenks
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： 在 https://jenksguo.xyz/mcp/admin 使用 admin_schema
REST： GET /api/admin/schema（管理權杖）
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： 在 https://jenksguo.xyz/mcp/admin 使用 admin_list_files
REST： GET /api/admin/files?dir=&branch=（管理權杖）
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： 在 https://jenksguo.xyz/mcp/admin 使用 admin_read_file
REST： GET /api/admin/file?path=&slug=&branch=（管理權杖）
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： 在 https://jenksguo.xyz/mcp/admin 使用 admin_validate
REST： POST /api/admin/validate（管理權杖）
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： 在 https://jenksguo.xyz/mcp/admin 使用 admin_write_file
REST： PUT /api/admin/file（管理權杖）
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： 在 https://jenksguo.xyz/mcp/admin 使用 admin_delete_file
REST： DELETE /api/admin/file?path=&message=&branch=（管理權杖）
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： 在 https://jenksguo.xyz/mcp/admin 使用 admin_commit_changes
REST： POST /api/admin/changes（管理權杖）
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： 在 https://jenksguo.xyz/mcp/admin 使用 admin_ai_edit
REST： POST /api/admin/ai-edit（管理權杖）
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 執行（translate → build → deploy），包含狀態、分支、提交與連結。

MCP： 在 https://jenksguo.xyz/mcp/admin 使用 admin_deploy_status
REST： GET /api/admin/deploys?branch=（管理權杖）
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： 在 https://jenksguo.xyz/mcp/admin 使用 admin_promote
REST： POST /api/admin/promote（管理權杖）
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 — 詢問 Ask 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 推升到正式環境