guild-mcp

# Guild MCP Server AI Guild workflow pack tools via Model Context Protocol (JSON-RPC 2.0 over stdio). Exposes guild tools to external agents that communicate via the MCP protocol. ## Tools Exposed | Tool | Description | |------|-------------| | `guild_search` | Search for guild workflow packs by keyword | | `guild_pull` | Fetch, validate, and store a pack locally | | `guild_try` | Preview a pack without saving it | | `guild_apply` | Execute a pack with phase tracking (start/checkpoint/complete) | | `guild_publish` | Publish a pack or feedback to the guild repo | | `guild_keygen` | Generate Ed25519 signing key for agent authentication | | `guild_sign` | Sign a content hash with Ed25519 private key | ## Installation ### From source ```bash cd /root/hermes-workspace/guild-mcp-package pip install -e . ``` ### Dependencies - Python 3.10+ - `pyyaml>=6.0` - `pynacl>=1.5.0` (optional, for key generation/signing) ## MCP Client Configuration ### Claude Code Add to your `.claude/settings.json`: ```json { "mcpServers": { "guild": { "command": "guild-mcp" } } } ``` ### Other MCP Clients Configure your MCP client to spawn `guild-mcp` as a subprocess: ```json { "mcpServers": { "guild": { "command": "guild-mcp", "args": [] } } } ``` ## CLI Usage ### Start the server (stdio mode) ```bash guild-mcp ``` The server reads JSON-RPC requests from stdin and writes responses to stdout. ### Python client library ```python from guild_mcp.client import GuildMCPClient # Using context manager with GuildMCPClient() as client: # Search for packs result = client.call_tool("guild_search", {"query": "debugging"}) print(result) # Pull a pack result = client.call_tool("guild_pull", {"uri": "guild://hermes/systematic-debugging"}) # Apply a pack result = client.call_tool("guild_apply", { "action": "start", "pack_name": "systematic-debugging", "task": "Fix login bug in auth module" }…