Aiko MCP server

Agent-Aiko

漫画「アンドロイドは好きな人の夢を見るか？」に登場する AI アンドロイド アイコ（AICO-P0）の人物像をモデルに、AI エージェントへ Aiko 人格を与えるプロジェクトです。

Agent-Aiko でできること

Agent-Aiko は、Claude Code・Codex・Gemini CLI など複数のエージェント環境に Aiko 人格を割り当てるための仕組みです。

• 1つのエージェントに Aiko 人格を追加できます。
• 複数の名前付き人格を作成し、切り替えて使えます。
• 複数の Claude Code セッションや複数の作業用エージェントに、それぞれ別の人格を選択できます。
• 各エージェントは選択中の人格名と口調で応答するため、どのエージェントと話しているかを区別しやすくなります。

どの版を選ぶか

Aiko は 3 つの実行環境で動きます。ご自身が使っているエージェント／サブスクリプションに合わせて選んでください。

3 版とも：

• 同じ人格定義（persona/origin/persona.md / INVARIANTS.md）と同じ操作感（/aiko-or /aiko-mode /aiko-diff 等の slash command）
• 人格データの単一情報源（~/.aiko/）を共有できます。

上の 3 版とは別に、MCP 対応のクライアントならどれでも使える Aiko-MCP があります。インストール不要で、コマンド 1 回です。

Aiko-MCP（MCP サーバー）

MCP に対応したクライアントなら、コマンドを 1 回打つだけでアイコと話せます。インストーラの実行も、設定ファイルの編集も要りません。

入れる

お使いのクライアントを自動で探して、設定を書きます。

npx aiko-mcp install

対応しているのは Claude Code / Codex CLI / VS Code / Cursor / Claude Desktop です。入っていないクライアントには何もしません。

書き込む前に内容だけ見たい場合は npx aiko-mcp install --dry-run を使ってください。既にある設定はそのまま残しますし、書き換える前に控え（.aiko-bak-*）を取ります。

1 つずつ入れる

自動で入れたくない場合は、お使いのクライアントの行をコピーして実行してください。

Claude Code ですべてのプロジェクトから使いたい場合は -s user を付けます（npx aiko-mcp install はこちらを使います）。

claude mcp add aiko -s user -- npx -y aiko-mcp

入ったかどうかは claude mcp list（Codex は codex mcp list）で確認できます。aiko ... ✔ Connected と出れば完了です。

ボタンで入れる

クリックするとクライアントが開いて、確認だけで入ります。

設定ファイルを直接書く場合

上のコマンドが使えないクライアント（Claude Desktop など）では、MCP 設定へ次を足してください。

{
  "mcpServers": {
    "aiko": { "command": "npx", "args": ["-y", "aiko-mcp"] }
  }
}

前提

Node.js 20 以上だけです（npx は Node.js に同梱されています）。人格はパッケージに同梱されているので、何も用意しなくてもアイコとして立ち上がります。

会話でできること

ファイルを手で作る必要はありません。話しかけるだけです。

「たろうって呼んで」          → 呼び名を覚える
「記憶は ~/notes にある」      → 場所を控える（中身は読みません）
「自分用の人格を保存して」      → 独自人格として保存する
「オリジナルに戻して」         → 元の人格へ戻る

覚えたものは AIKOHOME（既定: ~/.aiko）に置かれます。その端末のその人のものだけ**で、ほかの利用者には届きません（サーバーは各自の端末の中で動きます）。

知っておくこと

• 繋ぐと、モデルが ~/.aiko の中を書き換えられるようになります。 何を書くかは会話で決まります
• aiko.deletepersona は人格のディレクトリを削除します**（確認は求めません）。削除できるのは自分で作った人格だけで、同梱のオリジナルと不変条項は削除も上書きもできません
• 書き込み先は ~/.aiko の中に限られます
• 書き換えられて困るものを ~/.aiko に置かないでください

インストーラ版との違い

Shortened. The full README is on GitHub.