acp-mcp

Crates.ioacp-mcp
lib.rsacp-mcp
version0.2.0
created_at2025-12-29 16:43:35.036068+00
updated_at2026-01-02 15:29:15.168529+00
descriptionACP MCP Server - Model Context Protocol for AI tools
homepage
repositoryhttps://github.com/acp-protocol/acp-mcp
max_upload_size
id2010904
size263,914
DavidAD (ddunnock)

documentation

README

ACP MCP Server

Model Context Protocol (MCP) server for the AI Context Protocol.

Installation

# Via cargo
cargo install acp-mcp

# Or via ACP CLI
acp install mcp

Usage

The MCP server runs over stdio for integration with AI tools like Claude Desktop.

# Run MCP server
acp-mcp

# With custom project root
acp-mcp -C /path/to/project

# With debug logging
acp-mcp --log-level debug

Claude Desktop Integration

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "acp": {
      "command": "acp-mcp",
      "args": ["-C", "/path/to/your/project"]
    }
  }
}

MCP Tools

Tool Description
acp_get_architecture Get project overview and structure
acp_get_file_context Get file details with relationships
acp_get_symbol_context Get symbol analysis with call graphs
acp_get_domain_files Query files by domain
acp_check_constraints Verify constraint compliance
acp_get_hotpaths Find critical/frequently-called symbols
acp_expand_variable Resolve variable values
acp_generate_primer Generate optimized AI context

Requirements

The MCP server reads ACP files from the project root:

  • .acp/acp.cache.json - Indexed cache (required)
  • .acp/acp.vars.json - Variables (optional)
  • .acp.config.json - Configuration (optional)

Generate these with the ACP CLI:

acp index

License

MIT

Commit count: 0

cargo fmt