AIReady MCP Server
The AIReady MCP Server provides an integration point for AI agents (like Claude Desktop, Cursor, Windsurf, etc.) to assess AI-readiness and improve AI leverage directly within their conversational interfaces using the Model Context Protocol (MCP).
🛠 Capabilities
The AIReady MCP server exposes the following capabilities:
1. Analysis Tools
- Scan Tools: Run localized scans for
pattern-detect,context-analyzer,consistency,ai-signal-clarity,agent-grounding,testability,doc-drift,deps-health,change-amp, andcontract-enforce. get_remediation_diff: Get a precise code diff to fix identified AI-readiness issues.
2. Resources (Contextual Data)
aiready://project/summary: A high-level overview of the project's AI-readiness score and issue count.aiready://project/issues: A JSON list of the top 10 most critical issues found in the latest scan.aiready://project/graph: Raw dependency and fragmentation graph data for visualization.
3. Prompts (Templates)
analyze-project: A guided prompt to perform a full AI-readiness audit.remediate-issue: A template for fixing a specific issue using its ID.
---
🧱 Extension: AST Explorer Sibling
For deep code exploration, we also provide the @aiready/ast-mcp-server, which provides:
- Symbol resolution (
resolve_definition) - Reference finding (
find_references) - Call hierarchy (
get_call_hierarchy) - Implementation lookup (
find_implementations)
Configure it alongside AIReady:
"mcpServers": {
"aiready": {
"command": "npx",
"args": ["-y", "@aiready/mcp-server"]
},
"ast-explorer": {
"command": "npx",
"args": ["-y", "@aiready/ast-mcp-server"]
}
}Installation & Distribution Channels
1. Dedicated MCP Registries
- Smithery:
npx @smithery/cli install @aiready/mcp-server - Glama: View listing.
- Pulsar: Find on registry.
2. Direct IDE Integrations
Claude Desktop App / Cursor / Windsurf
Use the following command configuration:
npx -y @aiready/mcp-serverQuick Start
To test the server locally, you can run:
npx @aiready/mcp-serverFor more details on AIReady, visit getaiready.dev.
