Skip to main content
JGJenks Guo

ドキュメント / reference

MCP ツール

公開および管理用の MCP サーバー上のすべてのツール、その引数と例をまとめます。

サーバー

サーバー URL 認証
パブリック https://jenksguo.xyz/mcp なし
管理 https://jenksguo.xyz/mcp/admin Authorization: Bearer <admin token>
ローカル (stdio) jenks mcp / jenks mcp --admin env JENKSGUO_ADMIN_TOKEN(管理用)

トランスポート: Streamable 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 の 1 ページ 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 — 1 件のエントリを取得

スラッグで指定した経験・プロジェクト・コミュニティでの役割・学歴エントリの長文解説です: 概要、Jenks が行ったこと、成果、雇用主にとっての重要性、主要結果、スキル、証跡リンクを含みます。

  • MCP: get_entry on https://jenksguo.xyz/mcp
  • REST: GET /api/v1/entries/{slug}?locale=
  • CLI: jenks get <slug>
引数 型 必須 備考
slug string はい エントリのスラッグ。例: 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: 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 — コーパスを検索

すべてのエントリとドキュメントを横断してキーワード検索します。最も一致度の高いパッセージとそのスラッグを返します。

  • 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 のような 1 つのフォルダ内に限定することもできます。

  • 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 — 複数ファイルを一括コミット

複数のファイル変更を1つのコミットとして検証・コミットします。各変更は {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 で編集案を作成

サイトのモデルに、英語の平易な指示から 1 つのコンテンツファイルを書き直すよう依頼します。提案内容、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 実行(translate → build → deploy)を、ステータス、ブランチ、コミット、リンクとともに表示します。

  • 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の支援で翻訳されています。正式な肩書は英語のままです。