{"_id":"@amql/mcp-server","name":"@amql/mcp-server","dist-tags":{"alpha":"0.0.0-alpha.0","latest":"0.0.0-alpha.0"},"versions":{"0.0.0-alpha.0":{"name":"@amql/mcp-server","version":"0.0.0-alpha.0","description":"MCP server exposing AQL annotation queries as tools","bin":{"amql-mcp-server":"target/release/amql-mcp-server"},"scripts":{"build":"cargo build --release -p amql-mcp-server"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/vikr01/aql.git","directory":"crates/amql-mcp-server"},"engines":{"node":">=18.0.0"},"_id":"@amql/mcp-server@0.0.0-alpha.0","gitHead":"4ee0598df7c53c686813ef469453e946c91514be","bugs":{"url":"https://github.com/vikr01/aql/issues"},"homepage":"https://github.com/vikr01/aql#readme","_nodeVersion":"22.17.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-PKwxm68KOHFcgMuTX+czyV60WA9xYi+ghlsavhn2GwRNagf2UpysztrlR+wmwyMp8xrx2C3s5J8VAze0Mdm8VQ==","shasum":"3255472259f664eebbfffbf69d20998bc793e5bb","tarball":"https://registry.npmjs.org/@amql/mcp-server/-/mcp-server-0.0.0-alpha.0.tgz","fileCount":12,"unpackedSize":65198,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDhN+Dq8B2Z9BJ+F0U3QeP9pVwBzPjTtoz8LY+RAAg0zwIgSWOjgxe4CUbwuuaRO6aVoKvML0n48vuwkna7Dk4PLoo="}]},"_npmUser":{"name":"vikr01","email":"vik120@icloud.com"},"directories":{},"maintainers":[{"name":"vikr01","email":"vik120@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.0.0-alpha.0_1773349198192_0.6647822674045345"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-12T20:59:58.120Z","0.0.0-alpha.0":"2026-03-12T20:59:58.372Z","modified":"2026-03-12T20:59:58.581Z"},"maintainers":[{"name":"vikr01","email":"vik120@icloud.com"}],"description":"MCP server exposing AQL annotation queries as tools","homepage":"https://github.com/vikr01/aql#readme","repository":{"type":"git","url":"git+https://github.com/vikr01/aql.git","directory":"crates/amql-mcp-server"},"bugs":{"url":"https://github.com/vikr01/aql/issues"},"license":"MIT","readme":"# amql-mcp-server\n\n> Model Context Protocol server for AQL\n\n## Role\n\n- Thin shim over [amql-engine](../amql-engine)\n- Exposes all engine operations as MCP tools\n- No awareness of [amql-cli](../amql-cli) — both depend on the same core\n- Also available via `aql mcp` (CLI hosts this server)\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `aql_select` | Query annotations by selector |\n| `aql_query` | Unified annotation + code query |\n| `aql_extract` | Run extractors on source files |\n| `aql_validate` | Validate annotations against schema |\n| `aql_diff` | Compare annotations against baseline |\n| `aql_repair` | Suggest annotation fixes |\n| `aql_schema` | Discover annotation metadata |\n| `aql_stats` | Project statistics |\n| `aql_init` | Initialize AQL in a project |\n| `aql_locate` | Find sidecar for source file |\n| `aql_bench` | Benchmark AQL vs baselines |\n| `aql_nav_*` | AST navigation (select, expand, shrink, next, prev, read, insert, replace, remove, move) |\n| `aql_transact` | Atomic source mutations |\n| `aql_batch_mutate` | Parallel multi-file mutations |\n| `aql_batch_query` | Batch annotation queries |\n| `aql_coverage` | Annotation coverage analysis |\n| `aql_pattern` | Extract annotation patterns |\n| `aql_refresh` | Reload cached annotations |\n| `aql_spot_check` | Validate binding consistency |\n\n## Getting Started\n\n```sh\n# Standalone\namql-mcp-server\n\n# Via CLI\naql mcp\n\n# Claude Desktop config (~/.config/claude/claude_desktop_config.json)\n{\n  \"mcpServers\": {\n    \"aql\": {\n      \"command\": \"aql\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\n## License\n\n[MIT](../../LICENSE)\n","readmeFilename":"README.md","_rev":"1-3c2804010686fc987c932750b57c277e"}