Serviloj

Servilo	URL	Aŭtentigo
Public	https://jenksguo.xyz/mcp	none
Admin	https://jenksguo.xyz/mcp/admin	Authorization: Bearer <admin token>
Lokala (stdio)	jenks mcp / jenks mcp --admin	env JENKSGUO_ADMIN_TOKEN por administrado

Transporto: Fluebla HTTP, senstata, JSON-RPC 2.0 super POST (protokolo 2025-06-18). GET ĉe ambaŭ URL-oj liveras malkovran dokumenton. Servila nomo jenksguo, versio 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":{}}}'

Publikaj iloj

get_brief — Ricevu la resumon de Jenks

Unupaĝa Markdown-resumo pri Jenks Guo: poziciigado, nuna rolo, kariera arko, fortoj, lingvoj, kontakto, kaj kiel esplori plue. Komencu ĉi tie.

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

Neniuj argumentoj.

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

list_experience — Listigu spertojn

Listigu la spertojn de Jenks, projektojn, komunumarolojn kaj edukadon (plej novaj unue), laŭvole filtritajn per industriaj etikedoj, rol-lenso aŭ tipo. Redonas resumajn formojn: titolo, organizo, periodo, resumo, ŝlosila rezulto, paĝa URL.

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

Argumento	Tipo	Deviga	Notoj
tag	it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative	ne
lens	head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality	ne
kind	experience · education · community · project	ne
locale	en · zh · zh-hant · ja · fr · es · eo	ne	Lingvo por tradukitaj kampoj (defaŭlte en).

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

get_entry — Prenu unu eron

Plenlonga priskribo de unu sperto, projekto, komunumarolo aŭ eduk-ero laŭ slugo: superrigardo, kion faris Jenks, atingoj, kial tio gravas por dungantoj, ŝlosilaj rezultoj, kapabloj, pruvoligiloj.

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

Argumento	Tipo	Deviga	Notoj
slug	string	jes	Ero-slugo, ekz. xero-developer-evangelist
locale	en · zh · zh-hant · ja · fr · es · eo	ne	Lingvo por tradukitaj kampoj (defaŭlte en).

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

list_lenses — Listigu rol-lensojn

La rol-lensoj tra kiuj dungantoj povas rigardi Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) kun elproponanta prezento, honestaj mankoj kaj pruve-nombroj.

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

Argumento	Tipo	Deviga	Notoj
locale	en · zh · zh-hant · ja · fr · es · eo	ne	Lingvo por tradukitaj kampoj (defaŭlte en).

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

search_jenks — Serĉu en la korpuso

Ŝlosilvorta serĉo tra ĉiu ero kaj dokumento. Redonas la plej konvenajn pasaĵojn kun iliaj slugoj.

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

Argumento	Tipo	Deviga	Notoj
query	string	jes

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

get_document — Prenu dokumenton

Unu el la referencaj dokumentoj de Jenks: profile (kerna profilo), credentials (edukado, atestiloj), capabilities (kapablo → pruva mapo), talks (prelegoj, podkastoj, verkoj), thinking (mondrigardo).

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

Argumento	Tipo	Deviga	Notoj
name	profile · credentials · capabilities · talks · thinking	jes
locale	en · zh · zh-hant · ja · fr · es · eo	ne	Lingvo por tradukitaj kampoj (defaŭlte en).

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

ask_jenks — Demandu la asistanton de Jenks

Faru natur-lingvan demandon al la Ask Jenks-asistanto (rola taŭgeco, konsultada ampleksigo, konsiloj pri AI-transformo, STAR-rakontoj, gvidado…). Ĝi rulas siajn proprajn ilojn super la korpuso kaj respondas en la petita lingvo. Kun limigo de petfrekvenco.

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

Argumento	Tipo	Deviga	Notoj
question	string	jes
locale	en · zh · zh-hant · ja · fr · es · eo	ne	Lingvo por tradukitaj kampoj (defaŭlte en).
history	array	ne	Laŭvolaj pli fruaj turnoj.

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 iloj

admin_schema — Enhava skemo

La enhavmodelo: eraj kampoj kaj reguloj, etikedoj, lensoj, tipoj, skribeblaj vojoj, dokumentoj, kaj redaktaj konvencioj. Legu ĉi tion antaŭ ol verki.

• MCP: admin_schema ĉe https://jenksguo.xyz/mcp/admin
• REST: GET /api/admin/schema (admin ĵetono)
• CLI: jenks admin schema

Neniuj argumentoj.

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

admin_list_files — Listigu enhavajn dosierojn

Listigu redakteblajn enhavajn dosierojn en branĉo (vojo, grandeco, sha), laŭvole ene de unu dosierujo kiel content/corpus/experiences.

• MCP: admin_list_files ĉe https://jenksguo.xyz/mcp/admin
• REST: GET /api/admin/files?dir=&branch= (admin ĵetono)
• CLI: jenks admin ls [dir]

Argumento	Tipo	Deviga	Notoj
dir	string	ne	ekz. content/corpus/projects (defaŭlto: tuta enhavo)
branch	main · dev	ne	main publikigas al jenksguo.xyz; dev antaŭmontras ĉe dev.jenksguo.xyz (defaŭlte main).

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

admin_read_file — Legu enhavan dosieron

Legu la krudan Markdown/JSON-fonton de enhava dosiero (kun ĝia sha). Transdonu path, aŭ slug por ero, lenso aŭ kapablo.

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

Argumento	Tipo	Deviga	Notoj
path	string	ne
slug	string	ne
branch	main · dev	ne	main publikigas al jenksguo.xyz; dev antaŭmontras ĉe dev.jenksguo.xyz (defaŭlte main).

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

admin_validate — Validigu ŝanĝon

Validigu dosierenhavon kontraŭ la enhava skemo sen fari enmeton. Redonas liston de problemoj (malplena = valida).

• MCP: admin_validate ĉe https://jenksguo.xyz/mcp/admin
• REST: POST /api/admin/validate (admin ĵetono)
• CLI: jenks admin validate <path> <file>

Argumento	Tipo	Deviga	Notoj
path	string	jes
content	string	jes

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 — Kreu aŭ ĝisdatigu enhavan dosieron

Validigu kaj enmetu unu enhavan dosieron (krei aŭ anstataŭigi). Publikigado estas aŭtomata: CI re-tradukas ŝanĝitajn erojn en ĉiujn lingvojn, rekonstruas kaj deplojas (main → jenksguo.xyz, dev → dev.jenksguo.xyz) post kelkaj minutoj.

• MCP: admin_write_file ĉe https://jenksguo.xyz/mcp/admin
• REST: PUT /api/admin/file (admin ĵetono)
• CLI: jenks admin put <path> <file> -m <message>

Argumento	Tipo	Deviga	Notoj
path	string	jes
content	string	jes
message	string	jes	Enmeta mesaĝo
branch	main · dev	ne	main publikigas al jenksguo.xyz; dev antaŭmontras ĉe dev.jenksguo.xyz (defaŭlte 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 — Forigu enhavan dosieron

Forigu unu enhavan dosieron (ekz. forigi eron) kun enmeta mesaĝo. Git-historio tenas ĝin reakirebla.

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

Argumento	Tipo	Deviga	Notoj
path	string	jes
message	string	jes
branch	main · dev	ne	main publikigas al jenksguo.xyz; dev antaŭmontras ĉe dev.jenksguo.xyz (defaŭlte 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 — Enmetu plurajn dosierojn samtempe

Validigu kaj enmetu plurajn dosier-ŝanĝojn kiel UNU enmeto. Ĉiu ŝanĝo estas {path, content} aŭ {path, delete: true}.

• MCP: admin_commit_changes ĉe https://jenksguo.xyz/mcp/admin
• REST: POST /api/admin/changes (admin ĵetono)
• CLI: jenks admin commit <changes.json> -m <message>

Argumento	Tipo	Deviga	Notoj
changes	array	jes
message	string	jes
branch	main · dev	ne	main publikigas al jenksguo.xyz; dev antaŭmontras ĉe dev.jenksguo.xyz (defaŭlte 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 — Skizu redakton per AI

Petu la modelon de la retejo verki denove unu enhavan dosieron el instrukcio en simpla la angla. Redonas la proponitan enhavon, diferencon kaj validigajn problemojn. NE enmetas — kontrolu, poste voku admin_write_file.

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

Argumento	Tipo	Deviga	Notoj
path	string	ne
slug	string	ne
instruction	string	jes
branch	main · dev	ne	main publikigas al jenksguo.xyz; dev antaŭmontras ĉe dev.jenksguo.xyz (defaŭlte main).
content	string	ne	Laŭvola nekonservita dosierteksto por skizi el (defaŭlte: la konservita dosiero).

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 — Deploj-stato

Lastatempaj CI-lanĉoj (translate → build → deploy) kun stato, branĉo, enmeto kaj ligiloj.

• MCP: admin_deploy_status ĉe https://jenksguo.xyz/mcp/admin
• REST: GET /api/admin/deploys?branch= (admin ĵetono)
• CLI: jenks admin deploys

Argumento	Tipo	Deviga	Notoj
branch	main · dev	ne	main publikigas al jenksguo.xyz; dev antaŭmontras ĉe dev.jenksguo.xyz (defaŭlte main).

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

admin_promote — Promociu dev al produktado

Kunfandu la dev-branĉon en main, publikigante ĉion antaŭmontritan ĉe dev.jenksguo.xyz al jenksguo.xyz.

• MCP: admin_promote ĉe https://jenksguo.xyz/mcp/admin
• REST: POST /api/admin/promote (admin ĵetono)
• CLI: jenks admin promote

Argumento	Tipo	Deviga	Notoj
message	string	ne

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