ai-playbook-mcp

MCP client for ai-playbook. Connects AI coding tools (Kiro, Claude Code, etc.) to your playbook assets.

Installation

No manual installation needed. Use with npx:

// ~/.kiro/settings/mcp.json (또는 .kiro/settings/mcp.json)
{
  "mcpServers": {
    "ai-playbook": {
      "command": "npx",
      "args": ["ai-playbook-mcp"],
      "env": {
        "PLAYBOOK_API_URL": "https://playbook.cloudrudtjq1213.com",
        "PLAYBOOK_API_KEY": "your-api-key",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      },
      "autoApprove": ["list_catalog"]
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PLAYBOOK_API_URL | Yes | ai-playbook HTTP API server URL | | PLAYBOOK_API_KEY | No | API authentication key | | NODE_TLS_REJECT_UNAUTHORIZED | No | "0"으로 설정 시 SSL 검증 비활성화. Let's Encrypt 인증서 체인 인식 못 하는 환경에서 필요. |

Tools Provided

| Tool | Description | |------|-------------| | list_catalog | List all assets and groups (with optional type/tags filter) | | load_asset | Load full asset content (frontmatter + body) | | suggest_assets | Suggest relevant assets based on task description | | get_group | Get group details with included assets |