aidemd-mcp/server

MCP server that brings intent-driven development to any AI-powered IDE.
Manage .aide spec files that live next to your code — the domain context
that architects plan from, implementors build from, and QA validates against.
Learn more at aidemd.dev.
Features
- **Project-wide spec discovery** with a progressive disclosure tree that surfaces intent, research, and QA specs at every level of your codebase
- **One-command project bootstrap** via aide_init — wires methodology docs, pipeline commands, and this MCP server into your project in a single guided flow
- **Automatic naming convention enforcement** — aide_scaffold handles the .aide / intent.aide rename rules so you never create conflicting specs
- **Guarded pipeline cleanup** via aide_cleanup — removes a closed module's plan, todo and brief only when every checkbox is checked, and refuses with the exact open items otherwise
- **Health-check validation** via aide_validate — detects orphaned specs, missing descriptions, broken links, and naming conflicts before they cause drift
- **Code introspection** via aide_inspect — returns JSDoc, signatures, and kind for named symbols without opening files, giving agents Tier 2 progressive disclosure for code
- **Upgrade drift detection** via aide_upgrade — compares your project's AIDE methodology artifacts against canonical versions and writes updates per-category
- **Runtime brain entry-point** via aide_brain — on-demand tool that returns ready-to-execute prose telling the agent which MCP tools to call and how to reach whatever brain backend is wired, without the agent knowing which backend it is
Installation
Quick Start (Claude Code)
Pick a launch mode — init asks, recommends global, and never switches an existing entry.
**Global** — pick it on a personal machine: reliable startup, stays on the installed version.
**Local** — pick it for shared repos and cloud/CI: pinned to one exact version that /aide:upgrade moves forward.
--mode global|local skips the question (non-interactive runs default to local).
This command:
- Merges the AIDE MCP server entry into .mcp.json
- Writes the bundled brain config template to .aide/config/brain.aide (the brain location stays unset until /aide:brain config fills it and writes the brain MCP entry)
- Writes every pipeline slash command to .claude/commands/aide/
- Installs 10 canonical pipeline agents to .claude/agents/aide/ and the kanban-maintainer board agent to .claude/agents/kanban/
- Installs skills (study-playbook, brain, aide, aide-handoff, kanban, aide-brain-author) to .claude/skills/
- Installs the methodology docs hub to .aide/docs/
- Writes the aide-tree launcher to .aide/bin/aide-tree.mjs
- Adds an AIDE badge to README.md (appends if not present)
All operations are additive — files that already exist are never overwritten. Safe to re-run at any time.
init asks for no brain location, path or token, and rejects backend flags such as --vault-path. --brain picks the bundled template (today only obsidian, the default).
After running, open Claude Code and run /aide. On the first run it routes to /aide:brain config, which fills the brain location in .aide/config/brain.aide, writes the brain MCP entry through sync, and seeds the brain. Anything else init could not finish is named in its closing follow-up list.
Syncing brain.aide to .mcp.json
Run this after editing .aide/config/brain.aide — for example, when you update the brain path argument in mcpServerConfig.args or rename the brain in the name field:
Global:
Local (use the version your aide entry pins):
sync reads .aide/config/brain.aide, copies mcpServerConfig verbatim into .mcp.json under the fixed brain key, and writes the name field as the server label. Every other key in mcpServers (including your aide entry and any personal MCP integrations) is left byte-identical. If a legacy obsidian key is present it is removed in the same write. The command is idempotent — running it twice produces the same .mcp.json bytes, and the second invocation prints already in sync without touching the file. Exit code is 0 on success (including the no-change case), 1 on a missing or malformed brain.aide or invalid .mcp.json, and 2 on --help.