文件 / reference

MCP 工具

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

伺服器

伺服器	URL	認證
公開	`https://jenksguo.pages.dev/mcp`	無
管理	`https://jenksguo.pages.dev/mcp/admin`	`Authorization: Bearer <agent token>` (jgx_agt_…，具範圍)
本機（stdio）	`jenks mcp` / `jenks mcp --admin`	env `JENKSGUO_ADMIN_TOKEN`（管理用）

Transport: Streamable HTTP、無狀態、JSON-RPC 2.0 over POST（協定 2025-06-18）。對任一 URL 發送 GET 會回傳 discovery 文件。伺服器名稱 jenksguo，版本 1.4.0。

curl -s https://jenksguo.pages.dev/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.pages.dev/mcp
REST: GET /api/v1/brief
CLI: jenks brief

無參數。

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

`list_experience` — 列出經歷

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

MCP: list_experience on https://jenksguo.pages.dev/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.pages.dev/api/v1/entries"

`get_entry` — 取得單一條目

以 slug 取得某一經歷、專案、社群角色或教育的完整長文：概述、Jenks 的作為、成就、對雇主的意義、關鍵成果、技能、佐證連結。

MCP: get_entry on https://jenksguo.pages.dev/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.pages.dev/api/v1/entries/xero-developer-evangelist"

`list_lenses` — 列出角色視角

雇主可用來看待 Jenks 的角色視角（Head of AI、solution architect、developer advocate、digital marketer、hospitality…），含推介、誠實缺口與證據數量。

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

參數	型別	必填	備註
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	否	翻譯欄位的語言（預設 en）。

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

`search_jenks` — 搜尋全文庫

跨所有條目與文件的關鍵字搜尋。回傳最佳匹配的片段與其 slug。

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

參數	型別	必填	備註
`query`	string	是

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

`get_document` — 取得文件

Jenks 的參考文件之一：profile（核心個人檔案）、credentials（學歷與證照）、capabilities（能力 → 證據地圖）、talks（演講、Podcast、寫作）、thinking（觀點：七個視角，以淺白文字與範例說明，另含更多信念）。

MCP: get_document on https://jenksguo.pages.dev/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.pages.dev/api/v1/documents/credentials"

`list_cvs` — 列出 Jenks 的履歷

Jenks 可下載的履歷（PDF）— AI Lead 履歷 — 含版本、日期、穩定 PDF 連結、下載連結、預覽圖片與早期版本。若要了解他的 Web3 經驗，使用 get_cv 的 slug web3 會回傳 AI 與 Web3 履歷（此列表不含）。

MCP: list_cvs on https://jenksguo.pages.dev/mcp
REST: GET /api/v1/cv?locale=
CLI: jenks cv

參數	型別	必填	備註
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	否	翻譯欄位的語言（預設 en）。

curl -s "https://jenksguo.pages.dev/api/v1/cv"

`get_cv` — 取得單一履歷

依 slug 取得履歷：標題、摘要、版本、穩定 PDF 連結（永遠指向目前版本，如 https://jenksguo.pages.dev/cv/ai.pdf）、下載連結與全部版本。AI Lead 履歷用 ai；若有人詢問他的 Web3 經驗，使用 web3 取得 AI 與 Web3 履歷。

MCP: get_cv on https://jenksguo.pages.dev/mcp
REST: GET /api/v1/cv/{slug}?locale=
CLI: jenks cv <slug> [--download] [-o file.pdf]

參數	型別	必填	備註
`slug`	string	是	ai（AI Lead 履歷）或 web3（AI 與 Web3 履歷，供 Web3 問題）
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	否	翻譯欄位的語言（預設 en）。

curl -s "https://jenksguo.pages.dev/api/v1/cv/xero-developer-evangelist"

`list_arguments` — 列出支持 Jenks 的論點

依能力列出支持 Jenks 的論點 — AI 轉型、代理式系統、領導力、企業整合、DevRel、Web3 夥伴關係與跨專案的技術方案領導 — 各自附主張、限定條件與力度。

MCP: list_arguments on https://jenksguo.pages.dev/mcp
REST: GET /api/v1/arguments?locale=
CLI: jenks argue

參數	型別	必填	備註
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	否	翻譯欄位的語言（預設 en）。

curl -s "https://jenksguo.pages.dev/api/v1/arguments"

`get_argument` — 取得單一論點（含異議）

依 slug 取得一個論點：形式論證（前提 → 結論）、含數字的證據（條目 slug）、市場統計與來源、誠實限制、合理異議與回應、謬誤攻擊（形式與非形式）與回覆、以及何時不適用。用來檢測 Jenks 的適配度，而非僅為推銷。

MCP: get_argument on https://jenksguo.pages.dev/mcp
REST: GET /api/v1/arguments/{slug}?locale=
CLI: jenks argue <slug>

參數	型別	必填	備註
`slug`	string	是	ai-transformation、agentic-systems、leadership、enterprise-integration、devrel、web3-partnerships 或 technical-program-leadership
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	否	翻譯欄位的語言（預設 en）。

curl -s "https://jenksguo.pages.dev/api/v1/arguments/xero-developer-evangelist"

`ask_jenks` — 詢問 Jenks 的助理

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

MCP: ask_jenks on https://jenksguo.pages.dev/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.pages.dev/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question":"Is Jenks a fit for a Head of AI role?"}'

管理工具

`admin_whoami` — 我是誰

檢查你的憑證：你是誰（SSO 電子郵件或 agent token 名稱）、你的範圍、token 何時到期，以及是否已設定發佈（GitHub）。

MCP: admin_whoami on https://jenksguo.pages.dev/mcp/admin
REST: GET /api/admin/whoami (agent token)
範圍: read
CLI: jenks admin whoami

無參數。

curl -s "https://jenksguo.pages.dev/api/admin/whoami" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_audit_log` — 稽核記錄

最近的管理動作，最新在前：誰（SSO 電子郵件或 agent token）、做了什麼、哪些檔案、分支、主機與結果。agent token 只能看到自己的動作。

MCP: admin_audit_log on https://jenksguo.pages.dev/mcp/admin
REST: GET /api/admin/audit?limit=&token= (agent token)
範圍: read
CLI: jenks admin audit [--limit 50]

參數	型別	必填	備註
`limit`	integer	否
`token`	string	否	僅此 agent token id（僅人員可用）

curl -s "https://jenksguo.pages.dev/api/admin/audit" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_schema` — 內容綱要

內容模型：條目欄位與規則、標籤、視角、類型、可寫入路徑、文件與編輯慣例。寫入前請先閱讀。

MCP: admin_schema on https://jenksguo.pages.dev/mcp/admin
REST: GET /api/admin/schema (agent token)
範圍: read
CLI: jenks admin schema

無參數。

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

`admin_list_files` — 列出內容檔案

列出某分支上的可編輯內容檔案（路徑、大小、sha），可選擇限制於某資料夾，如 content/corpus/experiences。

MCP: admin_list_files on https://jenksguo.pages.dev/mcp/admin
REST: GET /api/admin/files?dir=&branch= (agent token)
範圍: read
CLI: jenks admin ls [dir]

參數	型別	必填	備註
`dir`	string	否	例如 content/corpus/projects（預設：全部內容）
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

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

`admin_read_file` — 讀取內容檔案

讀取內容檔案的原始 Markdown/JSON 來源（含其 sha）。可傳 path，或對條目、視角或技能傳 slug。

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

參數	型別	必填	備註
`path`	string	否
`slug`	string	否
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

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

`admin_validate` — 驗證變更

依內容綱要驗證檔案內容而不提交。回傳問題列表（空列表表示有效）。

MCP: admin_validate on https://jenksguo.pages.dev/mcp/admin
REST: POST /api/admin/validate (agent token)
範圍: read
CLI: jenks admin validate <path> <file>

參數	型別	必填	備註
`path`	string	是
`content`	string	是

curl -s -X POST https://jenksguo.pages.dev/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.pages.dev 與 jenksguo.xyz，dev → dev.jenksguo.xyz），數分鐘內完成。

MCP: admin_write_file on https://jenksguo.pages.dev/mcp/admin
REST: PUT /api/admin/file (agent token)
範圍: content（分支 main 另需 publish）
CLI: jenks admin put <path> <file> -m <message>

參數	型別	必填	備註
`path`	string	是
`content`	string	是
`message`	string	是	提交訊息
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

curl -s -X PUT https://jenksguo.pages.dev/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.pages.dev/mcp/admin
REST: DELETE /api/admin/file?path=&message=&branch= (agent token)
範圍: content（分支 main 另需 publish）
CLI: jenks admin rm <path> -m <message>

參數	型別	必填	備註
`path`	string	是
`message`	string	是
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

curl -s -X DELETE https://jenksguo.pages.dev/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.pages.dev/mcp/admin
REST: POST /api/admin/changes (agent token)
範圍: content（分支 main 另需 publish）
CLI: jenks admin commit <changes.json> -m <message>

參數	型別	必填	備註
`changes`	array	是
`message`	string	是
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

curl -s -X POST https://jenksguo.pages.dev/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.pages.dev/mcp/admin
REST: POST /api/admin/ai-edit (agent token)
範圍: content
CLI: jenks admin ai-edit <slug|path> "<instruction>" [--apply]

參數	型別	必填	備註
`path`	string	否
`slug`	string	否
`instruction`	string	是
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。
`content`	string	否	可選：從尚未儲存的檔案文字擬稿（預設：已儲存檔案）。

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

`admin_read_translation` — 讀取翻譯

以另一語言讀取單一內容檔案：英文來源欄位、當前翻譯與其狀態（最新、過期、人工編修、缺失）。適用於條目、視角、履歷、論點、觀點頁、學經歷、演講與說明文件。語言：zh、zh-hant、ja、fr、es、eo。

MCP: admin_read_translation on https://jenksguo.pages.dev/mcp/admin
REST: GET /api/admin/translation?path=&slug=&locale=&branch= (agent token)
範圍: read
CLI: jenks admin tr get <slug|path> <locale>

參數	型別	必填	備註
`path`	string	否
`slug`	string	否
`locale`	`zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	是
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

curl -s "https://jenksguo.pages.dev/api/admin/translation" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_write_translation` — 編輯翻譯

以另一語言（zh、zh-hant、ja、fr、es、eo）寫入單一內容檔案的文字 — 例如改善中文摘要。僅提供要變更的欄位；請先用 admin_read_translation 取得欄位名稱。Markdown 必須保留英文標題、程式碼區塊與連結。編修會被保留，直到英文變更；之後該語言會自動再次翻譯。英文為來源：請用 admin_write_file 變更英文。

MCP: admin_write_translation on https://jenksguo.pages.dev/mcp/admin
REST: PUT /api/admin/translation (agent token)
範圍: content（分支 main 另需 publish）
CLI: jenks admin tr put <slug|path> <locale> <fields.json> -m <message>

參數	型別	必填	備註
`path`	string	否
`slug`	string	否
`locale`	`zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	是
`fields`	object	是	例如 {"summary": "…", "body": "## …"}
`message`	string	否	提交訊息
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

curl -s -X PUT https://jenksguo.pages.dev/api/admin/translation \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"locale":"<locale>","fields":"<fields>"}'

`admin_read_copy` — 讀取站點文案

站點介面文字的單一語言版本 — 選單、頁面標題、單行頁面導言、Hero 標語、按鈕、SEO 描述 — 以 key → text 呈現，並附上英文（以及 zh-hant 也會附中文）。可用前綴過濾，如 hero 或 career。

MCP: admin_read_copy on https://jenksguo.pages.dev/mcp/admin
REST: GET /api/admin/copy?locale=&prefix=&branch= (agent token)
範圍: read
CLI: jenks admin copy get <locale> [prefix]

參數	型別	必填	備註
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	是
`prefix`	string	否
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

curl -s "https://jenksguo.pages.dev/api/admin/copy" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_write_copy` — 編輯站點文案

變更單一語言的介面文字：values 為 key → text（"" 會移除你的編修）。en 與 zh 為手寫來源：英文變更會自動翻譯為 ja、fr、es 與 eo — 也請同時設定 zh。其他語言的編修會保留，直到其來源文字變更。請原樣保留 {placeholders}。

MCP: admin_write_copy on https://jenksguo.pages.dev/mcp/admin
REST: PUT /api/admin/copy (agent token)
範圍: content（分支 main 另需 publish）
CLI: jenks admin copy set <locale> <key> "<text>" -m <message>

參數	型別	必填	備註
`locale`	`en` · `zh` · `zh-hant` · `ja` · `fr` · `es` · `eo`	是
`values`	object	是	例如 {"hero.sub": "…"}
`message`	string	否
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

curl -s -X PUT https://jenksguo.pages.dev/api/admin/copy \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"locale":"<locale>","values":"<values>"}'

`admin_deploy_status` — 部署狀態

最近的 CI 執行（translate → build → deploy），附狀態、分支、提交與連結。

MCP: admin_deploy_status on https://jenksguo.pages.dev/mcp/admin
REST: GET /api/admin/deploys?branch= (agent token)
範圍: read
CLI: jenks admin deploys

參數	型別	必填	備註
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

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

`admin_promote` — 將 dev 升版至正式環境

將 dev 分支合併至 main，發佈所有已在 dev.jenksguo.xyz 預覽的內容到正式站（jenksguo.pages.dev 與 jenksguo.xyz）。

MCP: admin_promote on https://jenksguo.pages.dev/mcp/admin
REST: POST /api/admin/promote (agent token)
範圍: publish
CLI: jenks admin promote

參數	型別	必填	備註
`message`	string	否

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

`admin_publish_cv` — 發佈新履歷版本

上傳某履歷（ai、web3 或新 slug）的新 PDF，並一步將其設為目前版本：PDF 進入媒體庫、先前版本移至履歷歷史（仍可下載）、並提交變更（CI 會發佈）。可選預覽圖片與新標題／摘要。穩定連結 /cv/.pdf 之後會提供新檔案。

MCP: admin_publish_cv on https://jenksguo.pages.dev/mcp/admin
REST: POST /api/admin/cv (agent token)
範圍: content + media（分支 main 另需 publish）
CLI: jenks admin cv publish <slug> <file.pdf> --cv-version 2026.10 [--preview /media/…]

參數	型別	必填	備註
`slug`	string	是	ai、web3，或新的 kebab-case id
`version`	string	是	例如 2026.10
`filename`	string	否
`data`	string	否	PDF 位元組，base64
`url`	string	否	`data` 的替代：PDF 的 https URL
`preview`	string	否	選用：已上傳之 /media/… 第 1 頁圖片
`title`	string	否
`summary`	string	否
`message`	string	否	提交訊息
`branch`	`main` · `dev`	否	main 發佈正式站（jenksguo.pages.dev 及其鏡像 jenksguo.xyz）；dev 發佈至 dev.jenksguo.xyz 預覽（預設 main）。

curl -s -X POST https://jenksguo.pages.dev/api/admin/cv \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"slug":"<slug>","version":"<version>"}'

`admin_list_media` — 列出媒體

列出已上傳的圖片、影片與 PDF（新到舊）：url、類型、大小、尺寸、替代文字、可直接貼上的 Markdown，以及每個檔案被哪些條目使用。

MCP: admin_list_media on https://jenksguo.pages.dev/mcp/admin
REST: GET /api/admin/media?prefix=&cursor=&limit= (agent token)
範圍: read
CLI: jenks admin media ls [prefix]

參數	型別	必填	備註
`prefix`	string	否	Key 前綴，如 2026/10
`cursor`	string	否
`limit`	integer	否

curl -s "https://jenksguo.pages.dev/api/admin/media" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_upload_media` — 上傳媒體

儲存圖片（webp、jpg、png、gif、avif、svg）、影片（mp4、webm）或 PDF，大小上限 25 MB，至 Cloudflare R2，並取得其公開 /media/… URL 與 Markdown。以 base64 data 搭配 filename 傳送，或提供公開 https url 以匯入。檔案上傳後即以 URL 公開；可用 admin_write_file 從內容引用。REST 端點亦接受 multipart/form-data（欄位 file）。

MCP: admin_upload_media on https://jenksguo.pages.dev/mcp/admin
REST: POST /api/admin/media (agent token)
範圍: media
CLI: jenks admin media upload <file|https-url> [--alt "…"]

參數	型別	必填	備註
`filename`	string	否	原始檔名；會成為 URL 中可讀的部分。
`data`	string	否	檔案位元組，base64（允許 data: URL 前綴）。
`url`	string	否	`data` 的替代：伺服器下載的 https URL。
`alt`	string	否	Alt 文字：圖片內容描述，供螢幕閱讀器與機器人使用。
`width`	integer	否
`height`	integer	否

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

`admin_update_media` — 更新媒體替代文字

變更已上傳檔案所儲存的替代文字（插入內容時的預設 alt）。

MCP: admin_update_media on https://jenksguo.pages.dev/mcp/admin
REST: PATCH /api/admin/media (agent token)
範圍: media
CLI: jenks admin media alt <key> "<alt text>"

參數	型別	必填	備註
`key`	string	是	媒體 key 或 url，如 2026/10/xero-talk-1a2b3c4d5e.webp
`alt`	string	是

curl -s -X PATCH https://jenksguo.pages.dev/api/admin/media \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"key":"<key>","alt":"<alt>"}'

`admin_delete_media` — 刪除媒體

永久刪除一個已上傳檔案。若仍被已發佈內容使用則會被拒絕，除非 force 為 true。不可復原 — 與內容檔案不同，這裡沒有 git 歷史。

MCP: admin_delete_media on https://jenksguo.pages.dev/mcp/admin
REST: DELETE /api/admin/media?key=&force= (agent token)
範圍: media
CLI: jenks admin media rm <key> [--force]

參數	型別	必填	備註
`key`	string	是
`force`	boolean	否

curl -s -X DELETE https://jenksguo.pages.dev/api/admin/media \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"key":"<key>"}'

.md本頁內容在 AI 協助下翻譯；官方職稱保留英文。

MCP 工具

伺服器

公開工具

get_brief — 取得 Jenks 的簡介

list_experience — 列出經歷

get_entry — 取得單一條目

list_lenses — 列出角色視角

search_jenks — 搜尋全文庫

get_document — 取得文件

list_cvs — 列出 Jenks 的履歷

get_cv — 取得單一履歷

list_arguments — 列出支持 Jenks 的論點

get_argument — 取得單一論點（含異議）

ask_jenks — 詢問 Jenks 的助理

管理工具

admin_whoami — 我是誰

admin_audit_log — 稽核記錄

admin_schema — 內容綱要

admin_list_files — 列出內容檔案

admin_read_file — 讀取內容檔案

admin_validate — 驗證變更

admin_write_file — 建立或更新內容檔案

admin_delete_file — 刪除內容檔案

admin_commit_changes — 一次提交多檔變更

admin_ai_edit — 以 AI 擬稿編輯

admin_read_translation — 讀取翻譯

admin_write_translation — 編輯翻譯

admin_read_copy — 讀取站點文案

admin_write_copy — 編輯站點文案

admin_deploy_status — 部署狀態

admin_promote — 將 dev 升版至正式環境

admin_publish_cv — 發佈新履歷版本

admin_list_media — 列出媒體

admin_upload_media — 上傳媒體

admin_update_media — 更新媒體替代文字

admin_delete_media — 刪除媒體

`get_brief` — 取得 Jenks 的簡介

`list_experience` — 列出經歷

`get_entry` — 取得單一條目

`list_lenses` — 列出角色視角

`search_jenks` — 搜尋全文庫

`get_document` — 取得文件

`list_cvs` — 列出 Jenks 的履歷

`get_cv` — 取得單一履歷

`list_arguments` — 列出支持 Jenks 的論點

`get_argument` — 取得單一論點（含異議）

`ask_jenks` — 詢問 Jenks 的助理

`admin_whoami` — 我是誰

`admin_audit_log` — 稽核記錄

`admin_schema` — 內容綱要

`admin_list_files` — 列出內容檔案

`admin_read_file` — 讀取內容檔案

`admin_validate` — 驗證變更

`admin_write_file` — 建立或更新內容檔案

`admin_delete_file` — 刪除內容檔案

`admin_commit_changes` — 一次提交多檔變更

`admin_ai_edit` — 以 AI 擬稿編輯

`admin_read_translation` — 讀取翻譯

`admin_write_translation` — 編輯翻譯

`admin_read_copy` — 讀取站點文案

`admin_write_copy` — 編輯站點文案

`admin_deploy_status` — 部署狀態

`admin_promote` — 將 dev 升版至正式環境

`admin_publish_cv` — 發佈新履歷版本

`admin_list_media` — 列出媒體

`admin_upload_media` — 上傳媒體

`admin_update_media` — 更新媒體替代文字

`admin_delete_media` — 刪除媒體