Aidemd

@aidemd-mcp/server

あらゆるAI搭載IDEにインテント主導の開発をもたらすMCPサーバーです。 コードの隣に配置する.aide仕様ファイルを管理します。これは、アーキテクトが計画を立て、実装者が構築し、QAが検証するためのドメインコンテキストです。

詳しくはaidemd.devをご覧ください。

特徴

• プロジェクト全体の仕様検出により、コードベースのあらゆる階層でインテント、リサーチ、QA仕様を表示する段階的開示ツリーを提供します
• aide_initによるワンコマンドのプロジェクト初期化で、ガイド付きの単一フローを通じて、方法論のドキュメント、パイプラインコマンド、このMCPサーバーをプロジェクトに組み込みます
• 命名規則の自動適用により、aide_scaffoldが.aide／intent.aideの名前変更ルールを処理するため、競合する仕様を作成せずに済みます
• aide_cleanupによるガード付きパイプラインのクリーンアップでは、すべてのチェックボックスにチェックが入っている場合に限り、完了したモジュールのプラン、TODO、ブリーフを削除します。そうでない場合は、未完了の項目を正確に示して処理を拒否します
• aide_validateによるヘルスチェック検証で、仕様の孤立、説明の欠落、リンク切れ、命名の競合を、問題がずれを引き起こす前に検出します
• aide_inspectによるコードのイントロスペクションでは、ファイルを開かずに、指定されたシンボルのJSDoc、シグネチャ、種類を返し、エージェントにコードのTier 2段階的開示を提供します
• aide_upgradeによるアップグレード時の差分検出では、プロジェクトのAIDE方法論アーティファクトを標準バージョンと比較し、カテゴリごとに更新を書き込みます
• aide_brainによるランタイムのブレイン用エントリーポイントは、オンデマンドで利用できるツールです。エージェントにバックエンドの種類を知らせることなく、呼び出すMCPツールと、接続されているブレインバックエンドへのアクセス方法をエージェントに伝える、すぐに実行できる文章を返します

インストール

クイックスタート（Claude Code）

起動モードを選択します。init は確認を行い、グローバルを推奨します。また、既存のエントリーは切り替えません。

グローバル — 個人のマシンで選択してください。安定して起動し、インストール済みのバージョンを使い続けます。

npm i -g @aidemd-mcp/server
aidemd-mcp init

ローカル — 共有リポジトリやクラウド／CIで選択してください。/aide:upgrade で更新する、特定のバージョンに固定されます。

npx -y @aidemd-mcp/[email protected] init

--mode global|local を指定すると確認を省略します（非対話型の実行では、デフォルトでローカルになります）。

このコマンドは次の処理を行います。

• AIDE MCP サーバーのエントリーを .mcp.json にマージします
• 同梱の脳設定テンプレートを .aide/config/brain.aide に書き込みます（/aide:brain config が脳の場所を設定し、脳の MCP エントリーを書き込むまで、脳の場所は未設定のままです）
• すべてのパイプラインスラッシュコマンドを .claude/commands/aide/ に書き込みます
• 11個の標準エージェントを .claude/agents/aide/ にインストールします（パイプラインエージェントに加え、プロジェクト独自のファイルを移行するために /aide:upgrade が実行する aide-upgrader を含みます）。また、kanban-maintainer ボードエージェントを .claude/agents/kanban/ にインストールします
• スキル（study-playbook、brain、aide、aide-handoff、kanban、aide-brain-author）を .claude/skills/ にインストールします
• 方法論ドキュメントのハブを .aide/docs/ にインストールします
• aide-tree ランチャーを .aide/bin/aide-tree.mjs に書き込みます
• AIDE バッジを README.md に追加します（存在しない場合は末尾に追加します）

すべての操作は追加のみで、既存のファイルが上書きされることはありません。いつでも安全に再実行できます。

init は脳の場所、パス、トークンを尋ねず、--vault-path などのバックエンド用フラグは受け付けません。--brain <integration> を指定すると、同梱のテンプレートを選択します（現時点では obsidian のみで、これがデフォルトです）。

実行後、Claude Code を開いて /aide を実行します。初回実行時は /aide:brain config に案内されます。このコマンドは .aide/config/brain.aide に脳の場所を設定し、同期処理で脳の MCP エントリーを書き込み、脳の初期設定を行います。init が完了できなかったその他の作業は、最後のフォローアップ一覧に記載されます。

brain.aide を .mcp.json に同期する

.aide/config/brain.aide を編集した後に実行します。たとえば、mcpServerConfig.args の脳パス引数を更新した場合や、name フィールドの脳の名前を変更した場合です。

グローバル：

aidemd-mcp sync

ローカル（aide エントリーで固定されているバージョンを使用してください）：

npx -y @aidemd-mcp/[email protected] sync

sync は .aide/config/brain.aide を読み取り、mcpServerConfig をそのまま固定の brain キーの下に .mcp.json へコピーし、name フィールドをサーバーのラベルとして書き込みます。mcpServers 内のその他すべてのキー（aide エントリーや個人用の MCP 統合を含む）は、バイト単位で変更されずに保持されます。従来の obsidian キーが存在する場合は、同じ書き込み処理で削除されます。このコマンドは冪等です。2回実行しても同じ .mcp.json のバイト列が生成され、2回目の実行ではファイルに触れずに already in sync と表示されます。成功時（変更がない場合を含む）の終了コードは 0、brain.aide が存在しないか形式が不正な場合、または .mcp.json が無効な場合は 1、--help の場合は 2 です。

mcpServerConfig.args の脳パスを更新した後の出力例：

Read .aide/config/brain.aide
Wrote brain MCP entry into .mcp.json
  command: mcpvault
  args: [D:/notes/new-brain]
Done.

手動設定

Claude Code 以外のクライアントを使用する場合、または手動で設定する場合は、クライアントの MCP 設定ファイルにサーバーエントリーを追加します。

Claude Code

グローバル — 自分のマシンでの利用におすすめです。一度インストールしてから登録します。

npm i -g @aidemd-mcp/server
claude mcp add aide -- aidemd-mcp

または、プロジェクトの .mcp.json に追加します。

{
  "mcpServers": {
    "aide": {
      "command": "aidemd-mcp"
    }
  }
}

ローカル、バージョン固定 — 共有リポジトリやクラウド／CI向けです。

claude mcp add aide -- npx -y @aidemd-mcp/[email protected]

または、プロジェクトの .mcp.json に追加します。

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/[email protected]"]
    }
  }
}

メモ

上記のクイックスタートコマンドは、Claude Code ユーザー向けにこの処理を自動で行います。

Claude Desktop

設定ファイルの場所：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

グローバル — 自分のマシンでの利用におすすめです（npm i -g @aidemd-mcp/server の実行後）：

{
  "mcpServers": {
    "aide": {
      "command": "aidemd-mcp"
    }
  }
}

ローカル、バージョン固定 — 共有リポジトリやクラウド／CI 向け：

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/[email protected]"]
    }
  }
}

メモ

Claude Desktop はターミナルの PATH を引き継ぎません。nvm または Homebrew で Node を管理している場合、npx が見つからないことがあります。ターミナルで which npx を実行して絶対パスを取得し、上記の設定で "npx" をそのパスに置き換えてください。

設定を変更した後は、Claude Desktop を完全に終了してから再起動する必要があります。

Cursor

~/.cursor/mcp.json に追加します：

グローバル — 自分のマシンでの利用におすすめです（npm i -g @aidemd-mcp/server の実行後）：

{
  "mcpServers": {
    "aide": {
      "command": "aidemd-mcp"
    }
  }
}

ローカル、バージョン固定 — 共有リポジトリやクラウド／CI 向け：

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/[email protected]"]
    }
  }
}

VS Code / Copilot

.vscode/mcp.json に追加します：

グローバル — 自分のマシンでの利用におすすめです（npm i -g @aidemd-mcp/server の実行後）：

{
  "servers": {
    "aide": {
      "command": "aidemd-mcp"
    }
  }
}

ローカル、バージョン固定 — 共有リポジトリやクラウド／CI 向け：

{
  "servers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/[email protected]"]
    }
  }
}

メモ

VS Code / Copilot では、ルートキーとして "mcpServers" ではなく "servers" を使用します。誤ったルートキーを使うと、サーバーはエラーを表示せずに読み込みに失敗します。

Windsurf

~/.windsurf/mcp.json に追加します：

グローバル — 自分のマシンでの利用におすすめです（npm i -g @aidemd-mcp/server の実行後）：

{
  "mcpServers": {
    "aide": {
      "command": "aidemd-mcp"
    }
  }
}

ローカル、バージョン固定 — 共有リポジトリやクラウド／CI 向け：

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/[email protected]"]
    }
  }
}

ツール

aide_discover

プロジェクト内の .aide 仕様ファイルをスキャンし、各仕様の種類、場所、概要を示す段階的開示のツリーマップを返します。計画または ToDo リストには、たとえば [plan: approved] のようにステータスがインラインで表示され、レビュー済みの仕様には整合性が表示されます。

入力：

• path（文字列、任意）：詳細を確認するサブディレクトリです。指定すると、まず祖先チェーン（ルートから対象までの意図の連鎖）が表示され、各祖先の説明と整合性ステータスに続いて、概要と警告を含む詳細なサブツリーが表示されます。省略すると、プロジェクト全体の浅いマップ（場所と種類のみ）が返されます。

aide_read

.aide 仕様ファイルを完全なコンテキストとともに読み取り、ファイルの内容、分類された種類（intent/research/plan/todo）、同じディレクトリ内の関連仕様、および内容内で見つかったリンクを返します。

入力：

• path（文字列、必須）：読み取る .aide ファイルのパスです。

aide_scaffold

命名規則を自動的に適用して、新しい .aide 仕様ファイルを作成します。名前変更ルールにも対応しています。intent 仕様は既定で .aide ですが、同じフォルダーに research.aide がある場合は intent.aide になります。また、research.aide を作成すると、既存の .aide は自動的に intent.aide に名前が変更されます。

入力：

• directory（文字列、必須）：.aide ファイルを作成するディレクトリです。
• type（文字列、必須）：作成するファイルの種類です。次のいずれかです：intent、research、both、todo、plan、session。session は directory の指定にかかわらず、プロジェクトのセッション記録を .aide/session.aide に書き込みます。

既存のファイルを上書きすることはありません。すでに存在するファイルはスキップされ、その旨が報告されます。新しい intent 仕様の alignment は unreviewed に、新しい計画および ToDo リストの status は proposed に設定されます。

aide_cleanup

閉じたモジュールのパイプライン一時ファイル、すなわち brief.aide、todo.aide、plan.aide のみを削除します。削除前提条件はコードで適用されます。削除対象となる各ファイルには、閉じたステータスが記録されている必要があります。ステータスは completed（すべてのチェックボックスにチェックが入っていること）または abandoned です。ステータスが導入される前に作成されたファイルは、すべてのチェックボックスにチェックが入っていれば条件を満たします。proposed または approved のままのファイルがある場合、削除は拒否されます。brief.aide は、そのプランと一緒にのみ削除されます。また、放棄されたプランを削除する場合は、そのブリーフも削除されます。plan.aide がない場合は、閉じた todo.aide を単独で削除します。削除が拒否された場合、何も削除されず、チェックされていない各項目のファイル名と行番号が示されます。意図仕様、コード、.aide/session.aide には一切触れず、プロジェクト外のパスは拒否します。シェルを使わずクロスプラットフォームで動作するため、削除に rm の権限は必要ありません。ツール名で許可してください。

入力：

• path（文字列、必須）：一時ファイルを格納するモジュールフォルダー。プロジェクトルートからの相対パスです。
• dryRun（ブール値、任意）：何も削除せず、削除対象または削除を妨げる要因を報告します。確認専用です。実際の呼び出しも安全です。

aide_frontmatter

AIDE ファイルの管理対象となるフロントマター値を1つ読み取るか変更し、それ以外のバイト列はすべてそのまま保持します。意図仕様には alignment（unreviewed、aligned、misaligned）が設定されています。プラン、ブリーフ、todo リストには status が設定され、proposed → approved → completed、または abandoned へと変化します。completed と abandoned は最終ステータスです。completed にするには、すべての項目にチェックが入っている必要があります。approved ファイルを改訂すると、ステータスは proposed に戻ります。このツールは許可された変更のみを適用し、セッション記録、調査仕様、AIDE 以外のファイル、プロジェクト外のパスを拒否します。値をいつ変更するかは判断しません。変更を決めるのは、アライナー、QA、ユーザーの承認、または破棄処理です。

入力：

• path（文字列、必須）：AIDE ファイル。プロジェクトルートからの相対パスです。
• field（文字列、任意）：alignment または status。読み取りの場合は value とともに省略します。
• value（文字列、任意）：新しい値。

aide_inspect

ワークスペース内の指定した関数、メソッド、クラス、インターフェース、または型エイリアスについて、JSDoc ブロック、シグネチャ、種類を返します。コードを対象とした、段階的開示のティア2です。エージェントはファイルを開かずにシンボルの契約を把握できます。

入力：

• name（文字列、必須）：検索するシンボル名。
• file（文字列、任意）：検索対象を単一のファイルに限定します（プロジェクトルートからの相対パス）。

aide_validate

プロジェクト内の .aide 仕様ファイルの健全性をチェックします。孤立した仕様、欠落した仕様、命名の競合（同じフォルダーに .aide と intent.aide がある場合）、壊れたリンク、孤立した調査ファイル、フロントマターの説明の欠落、解析できないフロントマター、alignment が欠落している、または既知の値ではない意図仕様を検出します。

入力：

• path（文字列、任意）：検証するサブディレクトリ。省略した場合はプロジェクト全体が対象です。

aide_info

起動時の前提条件を報告するツールです。オーケストレーターが個別に分岐できる独立した2つのフィールドを返します。outdated は、プロジェクトの versions.json と同梱マニフェストを比較した、古い AIDE アーティファクトキーの配列です。brain は、プロジェクトの brain.aide 設定が .mcp.json に接続されているかを報告する { status, name?, hints } オブジェクトです。brain.status は5種類に限定されています。ok | no-brain-aide | brain-aide-invalid | no-mcp-entry | mcp-drift のいずれかで、.aide/config/brain.aide と .mcp.json を比較して判定します。ディスク上のパス検証は行いません。brain-aide-invalid は、ファイルは存在するものの使用できないことを意味し、fault を含みます。fault は、不足している必須セクションを示す missing-sections、または理由を含む malformed のいずれかです。後者は、ファイルを読み取れない場合も対象とします。name は brain.aide でユーザーが指定したラベルです。no-brain-aide と brain-aide-invalid の場合は含まれません。no-brain-aide と brain-aide-invalid のどちらからも復旧するには、/aide:brain config を実行します。hints は、復旧時にオーケストレーターが提示できる候補の Vault の場所を示す配列です。

入力：

（なし）

aide_brain

オンデマンドで脳への接続を開始するツールです。タスクの途中で脳にアクセスする必要がある場合に呼び出してください。/aide の起動ごとに呼び出してはいけません。起動時の脳の前提条件の状態は、すでに aide_info.brain.status で報告されています。起動時に aide_brain を呼び出すと、同じ処理が不要に重複します。

{ status, instructions } の2つのフィールドだけを返します。backend、connector、name は含まれません。status は aide_info.brain.status（ok | no-brain-aide | brain-aide-invalid | no-mcp-entry | mcp-drift）を反映します。instructions は常に空ではありません。ok の場合は、ユーザーの .aide/config/brain.aide にある選択されたセクション（オプションの kind 入力に応じて orientation または config）の本文をそのまま返します（サーバーによる置換はありません）。失敗状態の場合は、修正手順を示す文章が含まれます。no-brain-aide と brain-aide-invalid の場合は、どちらも /aide:brain config を案内します。brain-aide-invalid の内容は検出された fault に基づいて構成されます。つまり、不足している必須セクションの名前、または不正な形式の理由が示されます。ファイルが存在するものの読み取れない場合も含まれ、存在しないとは報告されません。no-mcp-entry と mcp-drift の場合は、ユーザーの aide エントリで使用されているランチャーを使って同期するよう案内します（aidemd-mcp sync または npx -y @aidemd-mcp/server@<version> sync）。

入力：

（なし）

aide_init

ガイド付きの一度に1ステップずつ進めるウィザードを使い、プロジェクトに AIDE 開発環境をセットアップします。最初の呼び出し（category なし）では、すべてのステップの状態と検出されたフレームワークの概要を返します。以降の呼び出し（category 指定あり）では、そのカテゴリの保留中ファイルをすべてディスクに書き込み、マニフェストを返します。

入力：

• framework（文字列、任意）：自動検出の代わりに特定のフレームワークを指定します。指定できる値：claude、cursor、windsurf、copilot。
• path（文字列、任意）：プロジェクトルートのカスタムパス。デフォルトはサーバーの作業ディレクトリです。
• category（文字列、任意）：このカテゴリの would-create ファイルをすべて書き込み、マニフェストを返します。指定できる値：framework、methodology、commands、agents、skills、mcp、brain、ide、readme。最初の呼び出しでメタデータのみの概要を取得する場合は省略します。
• aideMode（文字列、任意）：aide MCP エントリの起動モード。global（推奨）または local を指定します。category=mcp とともに指定します。
• brainMode（文字列、任意）：brain テンプレートのランチャーの起動モード。global または local を指定します。category=brain とともに指定します。

aide_upgrade

このプロジェクト内のAIDE方法論アーティファクトを正規バージョンと比較し、カテゴリごとにグループ化した差分を返します。最初の呼び出し（category なし）では、すべてのカテゴリのドリフト状況を簡潔にまとめて返します。以降の呼び出し（category あり）では、そのカテゴリの差分があるファイルまたは不足しているファイルをすべてディスクに書き込み、マニフェストを返します。

入力：

• framework（文字列、任意）：自動検出の代わりに、特定のフレームワークを指定します。指定できる値：claude、cursor、windsurf、copilot。
• path（文字列、任意）：プロジェクトのルートパスをカスタム指定します。デフォルトはサーバーの作業ディレクトリです。
• category（文字列、任意）：このカテゴリのドリフトがあるファイルまたは不足しているファイルをすべて書き込み、マニフェストを返します。指定できる値：pointer-stub、methodology-docs、version-metadata、commands、agents、skills、mcp、ide、readme。メタデータのみの概要を取得する最初の呼び出しでは省略します。

はじめに

MCP クライアントにサーバーを追加したら、エージェントに aide_init を実行して、プロジェクトにAIDE方法論を導入するよう依頼します。これにより、方法論のドキュメントがインストールされ、パイプラインコマンドが作成され、すべてが連携するよう設定されます。

次に、「認証モジュールのインテント仕様を作成して」と依頼してみましょう。エージェントは aide_discover を使ってプロジェクトをマッピングし、aide_scaffold を使って適切な場所に適切な命名規則で仕様を作成します。

開発

npm install
npm run build
npm test

ライセンス

MIT