MCP Integration¶
lazyai-cli maintains a canonical MCP catalog under .ai/ and compiles it into each tool’s native config format.
Canonical source¶
The canonical catalog is written to:
It contains the full catalog of bundled servers, including:
- server definitions
- whether each server is enabled or disabled
- install requirements
- command/URL configuration
- environment variable placeholders
Per-tool compilation¶
| Tool | Compiled MCP output | Notes |
|---|---|---|
| OpenCode | .opencode/opencode.jsonc |
Includes enabled + disabled servers |
| Claude Code | .mcp.json |
Includes only enabled servers |
| GitHub Copilot | .vscode/mcp.json |
Includes only enabled servers |
Enabling servers¶
During setup:
Or edit .ai/mcp.json later, then recompile:
Disabling servers¶
Edit .ai/mcp.json and set the server's enabled flag to false, then rerun lazyai-cli compile.
Bundled MCP servers¶
| Server | Default status | Requires install | Notes |
|---|---|---|---|
memory |
enabled | No | Knowledge graph memory server |
filesystem |
enabled | No | Local filesystem read/write access |
ripgrep |
enabled | No | Fast code search |
memoria |
enabled | No | Git history + code memory |
codegraph |
disabled | Yes | Semantic code graph (go install or project-specific install) |
qmd |
disabled | Yes | Markdown knowledge search (brew install qmd) |
playwright |
disabled | No | Browser automation and testing |
context7 |
disabled | No | Remote docs lookup; uses CONTEXT7_API_KEY |
atlassian |
disabled | No | Jira/Confluence remote access |
brave-search |
disabled | No | Web search; needs BRAVE_API_KEY |
fetch |
disabled | No | General HTTP fetch MCP |
orchestrator |
disabled | Yes | Optional LazyAI orchestration runtime (lazyai-orchestrator) |
Environment variables¶
If any enabled MCP server declares env vars, lazyai-cli generates:
Example:
lazyai-cli never writes real secrets into .env.example.
Orchestrator MCP server¶
When orchestrator is enabled, lazyai-cli scaffolds .ai/orchestration/ and generates per-tool orchestrator guidance files. Install the runtime with:
See Orchestration.