amql-mcp-server 0.0.0-alpha.0

MCP server exposing AQL annotation queries as tools
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# amql-mcp-server

> Model Context Protocol server for AQL

## Role

- Thin shim over [amql-engine](../amql-engine)
- Exposes all engine operations as MCP tools
- No awareness of [amql-cli](../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

```sh
# 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](../../LICENSE)