kireo

@kireo/mcp-server

MCP 互換の AI ツール（Claude Code、Cursor、Windsurf、Cline、Zed、Continue …）向けの長期記憶です。

Kireo memory MCP とは？

Kireo memory MCP は、Claude Code、Cursor、Cline、Windsurf、その他すべての MCP クライアントに長期記憶を提供する Model Context Protocol サーバーです。決定事項を一度保存すれば、後のあらゆるセッションや、どのマシンからでも呼び出せます。LanceDB を使ったセマンティック検索とキーワード検索のハイブリッド、12 個の MCP ツール、さらにローカルコードのインデックス作成に対応しています。無料ベータ版です。必要なのは API キーだけです。

Kireo memory MCP のインストール方法は？

Claude Code では 1 行、それ以外では同じ JSON ブロックを使います。どちらも https://app.kireo.app/app/api-keys で取得できる無料のキー（ki_sk_…）が必要です。

# Claude Code — add --scope user to get it in every project
claude mcp add kireo --scope user --env KIREO_API_KEY=ki_sk_xxx -- npx -y --package=@kireo/mcp-server kireo-mcp

それ以外のすべてのクライアントで使うサーバーエントリは同じです。異なるのは設定するファイルだけです。

{
  "mcpServers": {
    "kireo": {
      "command": "npx",
      "args": ["-y", "--package=@kireo/mcp-server", "kireo-mcp"],
      "env": { "KIREO_API_KEY": "ki_sk_xxx" }
    }
  }
}

クライアント	設定する場所
Claude Code	プロジェクトルートの .mcp.json（または上記の claude mcp add コマンドを使用）
Cursor	~/.cursor/mcp.json、または 1 つのリポジトリのみの場合は <workspace>/.cursor/mcp.json
Cline	MCP Servers → Configure MCP Servers（cline_mcp_settings.json）
Claude Desktop	claude_desktop_config.json（Settings → Developer → Edit Config）
Windsurf	~/.codeium/windsurf/mcp_config.json
Zed / Continue / その他の MCP ホスト	そのホストが MCP サーバー一覧と呼ぶ設定箇所。同じ 3 つのフィールドを使います

その後、クライアントを再起動してください。npx を使うには、Node.js ≥ 20 が PATH に設定されている必要があります。

利用できるツールは？

MCP stdio 経由で 12 個のツールを利用できます。memory_save、memory_search、memory_recall、memory_get、 memory_update、memory_delete、memory_list_namespaces、memory_health、context_save、 context_load、project_info、context_archive です。どのクライアントでも同じツールを利用できます。キーが機能することを確認するには、まず memory_health を呼び出してください。

プロンプトが肥大化しませんか？

いいえ。記憶はプッシュではなく、必要に応じて取得されます。システムプロンプトに何かが注入されることはありません。エージェントは、過去のコンテキストを取得する価値があると判断した場合にのみ memory_search を呼び出し、上限のあるランキング済みの結果（デフォルトは 10 件、最大 50 件）を受け取ります。そのため、トークンはターンごとではなく、クエリごとに消費されます。

CLAUDE.md / .cursorrules ファイルとはどう違いますか？

ルールファイルは静的なテキストで、毎回のセッションで全体が再読み込みされ、他のものと共有されません。Kireo memory MCP は必要に応じて検索でき、作業中にエージェントが書き込み、セマンティック検索が可能で、名前空間を通じてプロジェクト、セッション、マシンをまたいで共有されます。

コードベースのインデックスを作成できますか？

はい。npx -y -p @kireo/mcp-server kireo index ./ --repo my-app を実行すると、関数、クラス、メソッドが code-<repo> 名前空間に抽出され、memory_search から検索できるようになります。インデックス作成は増分方式です。再実行時には変更されたファイルのみが送信され、サーバーは同一のシンボルを重複排除するため、安全に再試行できます。

コードはアップロードされますか？

compact コマンドは、アーカイブするよう指示した会話の要約をアップロードします。context_save は引き継ぎ情報を、memory_save は指定した内容を、kireo index は抽出したコードシンボルをアップロードします。これらの操作では、内容が Kireo アカウントに送信されます。KIREO_TELEMETRY=0 を設定すると、X-Device-Id ヘッダーも送信されなくなります。

費用はいくらですか？

無料ベータ版です。https://app.kireo.app で登録し、キーを作成すれば完了です。カードは不要です。

会話の圧縮（0.3.0）

Kireo プラグインを使うと、Claude Code では /kireo:compact、Codex では $kireo-compact が追加されます。 表示中の会話を要約し、<directory-name>.md を作成して、オフライン時の再試行とバージョン管理されたファイルメタデータを用いて Kireo アカウントにアップロードします。 プラグインをインストール。

MCP には、以下の 8 つの汎用メモリツールに加えて、project_info、context_save、context_load、context_archive も用意されています。

クイックスタート

1. https://app.kireo.app/app/api-keys で API キーを取得します（ki_sk_…）。
2. この MCP サーバーをホストに追加します。Claude Code の場合は、次を実行します。

claude mcp add kireo --scope user --env KIREO_API_KEY=ki_sk_xxx -- npx -y --package=@kireo/mcp-server kireo-mcp

この行には重要な点が2つあります。どちらも、2026-08-03 に claude 2.1.220 と npm 11 で確認済みです。

• @kireo/mcp-server ではなく、--package=@kireo/mcp-server kireo-mcp を指定します。 このパッケージには2つのバイナリ（kireo、kireo-mcp）が含まれており、どちらもパッケージ名と同じ名前ではありません。そのため、npx -y @kireo/mcp-server では実行するバイナリを特定できず、could not determine executable to run というエラーになります。
• 短い -p ではなく、--package= を指定します。 -- の後に単独で指定した -p は claude mcp add のオプションパーサーに取り込まれ、パーサーが自身のフラグを拒否します。claude mcp add kireo --env … -- npx -y -p @kireo/mcp-server kireo-mcp は unknown option '--env' というエラーになります。長い形式なら問題なく解析されます。

現在のプロジェクトでのみ使う場合は、--scope user を削除してください。または、同じ形式のプロジェクトスコープの .mcp.json をリポジトリのルートに追加できます（JSON の args 内では短い -p を使用できます。これは npx に直接渡され、claude のパーサーには届きません）。

// .mcp.json (project root)
{
  "mcpServers": {
    "kireo": {
      "command": "npx",
      "args": ["-y", "--package=@kireo/mcp-server", "kireo-mcp"],
      "env": { "KIREO_API_KEY": "ki_sk_xxx" }
    }
  }
}

3. ホストを再起動します。AI が利用できるツールは12個になります。

ツール	目的
memory_save	長期メモリーを保存
memory_search	セマンティック検索とキーワード検索を組み合わせた検索
memory_recall	最近のメモリーや重要なメモリーを再生
memory_get	ID で取得
memory_update	フィールドを更新
memory_delete	論理削除／完全削除
memory_list_namespaces	名前空間を列挙
memory_health	サービスの状態を確認

設定

設定値は次の順に統合されます：CLI 引数 > env > ~/.kireo/config.json。

ENV / CLI	デフォルト	説明
KIREO_API_KEY / --api-key	必須	ベアラートークン（ki_sk_…）。
KIREO_API_URL / --api-url	https://api.kireo.app	セルフホスト用の URL。
KIREO_REQUEST_TIMEOUT_MS / --timeout	60000	リクエストごとのタイムアウト（ミリ秒）、最大 300000（環境変数の別名：KIREO_TIMEOUT_MS）。
KIREO_RETRY_MAX_ATTEMPTS	3	5xx／429 エラー時の再試行回数（別名：KIREO_RETRY_MAX）。
KIREO_RETRY_BASE_MS	200	指数バックオフの基準時間。
KIREO_TELEMETRY	1	デバイス ID ヘッダーを無効にするには 0 を指定します。
KIREO_LOG_LEVEL	info	debug／info／warn／error／silent。
KIREO_PROXY_URL	なし	HTTP(S) プロキシ。
KIREO_ACCEPT_LANGUAGE	en	エラーヒントのロケール。

すべてのプラットフォーム（macOS、Linux、Windows）で、ログは ~/.kireo/logs/ に出力されます。

ローカルコードのインデックス作成

リポジトリのシンボル（関数／クラス／メソッド）を code-<repo> 名前空間にインデックス化すると、AI は memory_search でそれらを呼び出せるようになります。

export KIREO_API_KEY=ki_sk_xxx
npx -y -p @kireo/mcp-server kireo index ./ --repo my-app

インデックス作成は増分方式です。2回目以降の実行では、変更されたファイルのみが再送信されます。

フラグ	デフォルト	説明
--repo <name>	ディレクトリ名	リポジトリ名 → code-<name> 名前空間。
--batch-size <n>	100	1回のアップロードで送信するシンボル数（1..100）。バッチがタイムアウトする場合は値を小さくします。
--timeout <ms>	60000	リクエストごとのタイムアウト（最大 300000）。
--api-key / --api-url / --namespace / --log-level / --no-telemetry	—	上記の設定表と同じです。CLI フラグは env より優先されます。

すべての使用方法は kireo --help で確認できます。--help と --version はネットワークにもファイルシステムにもアクセスせず、API キーも必要ありません。バッチのアップロードがタイムアウトした場合は、同じコマンドを再実行しても安全です。サーバーは同一のシンボルを重複排除するため、再試行しても重複は作成されません。

ホストのセットアップ

• Claude Code
• Cursor
• Windsurf

プライバシー

KIREO_TELEMETRY=0 を設定すると、X-Device-Id ヘッダーを送信しません。お客様のコードを読み取ることはありません。API に送信されるのは、memory_save に渡された明示的な内容のみです。

トラブルシューティング

• AUTH_INVALID_KEY → https://app.kireo.app/app/api-keys でキーをローテーションします。
• QUOTA_EXCEEDED → アップグレードするか、次の請求サイクルまでお待ちください。
• ホストでツールが見つからない場合 → npx @modelcontextprotocol/inspector node $(npm root -g)/@kireo/mcp-server/bin/kireo-mcp.cjs を実行して、ローカルで確認します。

ライセンス

MIT