Skip to main content
Glama

Playbook

手順は JSON として記述します。意図から検索し、タイトルをたどり、do を1つずつ読み込みます。

Playbook は、小さな CLI であり、かつ小さな MCP サーバーです。エージェント(またはあなた)が、プレイブック全体をコンテキストに含めずに、ハウツーを作成・検索・実行できます。CLI の操作は分割されたままです。MCP は関連する操作をより少ないツールにまとめます。すべてが JSON です。

Python 3.10+、実行時は 標準ライブラリのみ を使用します。

インストール

pip install -e .
playbook search

PyPI にはまだ公開されていません。

Related MCP server: servicenow-platform-mcp

ファイルの保存場所

手順ごとに1つの JSON ファイルが、プラットフォームのデータディレクトリに置かれます。

OS

ディレクトリ

Linux

~/.local/share/playbook/procedures/

macOS

~/Library/Application Support/playbook/procedures/

Windows

%LOCALAPPDATA%\playbook\Data\procedures\

XDG_DATA_HOME / APPDATA / LOCALAPPDATA を尊重します。コマンドはパスではなく、手順の id を受け取ります。

構成

{
  "id": "follow-playbook",
  "title": "Follow a playbook procedure",
  "description": "When to pick this file. Can be verbose.",
  "tags": ["playbook", "follow"],
  "steps": [
    {
      "id": "a1b2c3…",
      "title": "Search by intent",
      "do": "Call playbook_search with a sentence for the job."
    }
  ]
}
  • title — 検索カードに表示される短い名前

  • description — この手順を選ぶべきタイミング

  • steps — 順序付き。タイトルは一意。ステップ id はランダム。do が作業本体です。

CLI

playbook create demo --title "Demo" --description "when to pick this" --tags demo
playbook add-step demo --title "First" --do "Do the first thing."
playbook add-step demo --title "Middle" --do "Do the middle." --after "First"
playbook edit demo --title "Better title"
playbook search "I want to follow a procedure"
playbook load demo
playbook load demo --full
playbook start demo --title "First"
playbook validate demo
playbook mcp

すべてのコマンドは JSON を出力します(エラーを含む)。

search はヒント意図に基づく BM25 と文字 n-gram を組み合わせた検索です。ヒットするのは idtitledescription のみです(デフォルト 8 件、上限 50 件)。弱い一致は除外されます。

load はタイトルのみ返します。--full はすべての do を含みます。start は1つの dobefore / after のタイトルを返します。

MCP (Grok)

grok mcp add --scope user playbook -- playbook mcp

起動されたプロセスにシェルの PATH が引き継がれない場合は、playbook への絶対パスを使用してください。その後 /mcpsr を実行するか、新しいセッションを開いてください。

ツール

役割

playbook_search

意図に基づく検索

playbook_open

タイトルの読み込み、--full、または at でステップを開始

playbook_create

新しい手順の作成

playbook_edit

タイトル / 説明 / タグ

playbook_step

op: 追加 | 編集 | 削除

playbook_validate

検証

テスト

pip install -e .
python -m pytest tests/ -q

ライセンス

MIT

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/benteigland11/Playbook'

If you have feedback or need assistance with the MCP directory API, please join our Discord server