Angreal MCP Server

What is Angreal MCP Server?

An MCP (Model Context Protocol) server that provides AI assistants with discovery capabilities for angreal projects. It exposes angreal's command tree structure to MCP-compatible clients, enabling AI assistants to discover available commands and tasks, understand project structure, and suggest appropriate commands based on context.

How to use Angreal MCP Server?

Install via cargo install angreal_mcp (requires Rust toolchain). Configure an MCP client (Claude Code, Claude Desktop, or Cline) with the command angreal_mcp and optionally set the working directory to your angreal project root. Test via command line using JSON-RPC messages for tools/list or tools/call.

Key features of Angreal MCP Server

• Exposes angreal's command tree structure to AI assistants
• Provides the angreal_tree tool with JSON or human output
• Supports Claude Code, Claude Desktop, and Cline integrations
• Built with Rust for performance and reliability
• Dual-licensed under MIT or Apache 2.0

Use cases of Angreal MCP Server

• AI assistant discovers and suggests angreal commands during development
• Developer explores available tasks in an angreal project through an AI interface
• Automated workflows gain contextual understanding of project capabilities

FAQ from Angreal MCP Server

What is the angreal_tree tool?

It returns the command tree structure of the current angreal project. You can request output in "json" (default) or "human" format.

What are the prerequisites for using this server?

Angreal must be installed and available in your PATH. Rust toolchain is required only if building from source.

How do I install the server?

Install from crates.io: cargo install angreal_mcp. For the latest development version, use cargo install --git https://github.com/colliery-io/angreal-mcp.

Which MCP clients are supported?

Examples include Claude Code, Claude Desktop, and Cline. Each client requires a JSON configuration pointing to the angreal_mcp binary.

How can I test the server without a client?

Run JSON-RPC commands via the command line, e.g., echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | angreal_mcp to list available tools.