amql-mcp-server 0.0.0-alpha.0

MCP server exposing AQL annotation queries as tools
docs.rs failed to build amql-mcp-server-0.0.0-alpha.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

amql-mcp-server

Model Context Protocol server for AQL

Role

  • Thin shim over amql-engine
  • Exposes all engine operations as MCP tools
  • No awareness of amql-cli — both depend on the same core
  • Also available via aql mcp (CLI hosts this server)

Tools

Tool Description
aql_select Query annotations by selector
aql_query Unified annotation + code query
aql_extract Run extractors on source files
aql_validate Validate annotations against schema
aql_diff Compare annotations against baseline
aql_repair Suggest annotation fixes
aql_schema Discover annotation metadata
aql_stats Project statistics
aql_init Initialize AQL in a project
aql_locate Find sidecar for source file
aql_bench Benchmark AQL vs baselines
aql_nav_* AST navigation (select, expand, shrink, next, prev, read, insert, replace, remove, move)
aql_transact Atomic source mutations
aql_batch_mutate Parallel multi-file mutations
aql_batch_query Batch annotation queries
aql_coverage Annotation coverage analysis
aql_pattern Extract annotation patterns
aql_refresh Reload cached annotations
aql_spot_check Validate binding consistency

Getting Started

# Standalone
amql-mcp-server

# Via CLI
aql mcp

# Claude Desktop config (~/.config/claude/claude_desktop_config.json)
{
  "mcpServers": {
    "aql": {
      "command": "aql",
      "args": ["mcp"]
    }
  }
}

License

MIT