Aidemd MCP server

@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
• 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)

The fastest path is a single npx command that wires everything up automatically:

npx @aidemd-mcp/server@latest init

This command:

• Merges the AIDE MCP server entry into .mcp.json
• Merges a placeholder brain MCP entry into .mcp.json (vault path filled in by /aide)
• Writes every pipeline slash command to .claude/commands/aide/
• Installs 9 canonical pipeline agents to .claude/agents/aide/
• Installs skills (study-playbook, brain) 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.

Pass --vault-path to record your brain vault location at install time, skipping the vault-path prompt when /aide first runs.

After running, open Claude Code and run /aide — the orchestrator will prompt for any setup the cli could not finish (IDE choice, vault path if not supplied).

Syncing brain.aide to .mcp.json

Run this after editing .aide/config/brain.aide — for example, when you update the vault path argument in mcpServerConfig.args or rename the brain in the name field:

npx @aidemd-mcp/server@latest sync

Shortened. The full README is on GitHub.