Cairn.ink Memory
概要
作者による説明(英語の原文)
Cross-session memory for AI agents with a Source Receipt for every memory, over MCP.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi3項目中3項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況iとても新しい★ –
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: クラウドで動く
- トランスポート: Streamable HTTP
- カテゴリ: 検索・AIの記憶
- 入力が必要なもの:Authorization
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:3項目中3項目に合格
- 作者のサーバーで動きます。あなたが頼んだ内容は、作者のサーバーを通ります。
- 自分で入力するもの:
Authorization
「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
- クラウドで動くインストール不要。インターネット経由でつながります
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
このアドレスはリクエストの header にキーが必要ですが、コネクタを追加するメニューでは設定できません。代わりにClaude Code、Cursor、VS Codeを使ってください。
ターミナルでこれを実行します
claude mcp add --transport http memory https://cairn.ink/api/mcp --header 'Authorization: your-value'動かす前に、空欄の値を入力してください。
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"memory": {
"url": "https://cairn.ink/api/mcp",
"headers": {
"Authorization": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"memory": {
"type": "http",
"url": "https://cairn.ink/api/mcp",
"headers": {
"Authorization": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
このアドレスはリクエストの header にキーが必要ですが、コネクタを追加するメニューでは設定できません。代わりにClaude Code、Cursor、VS Codeを使ってください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
自分で入力する値
Authorization秘密 HTTP headerOptional. Bearer from https://cairn.ink/settings/tokens. Clients that support OAuth discover authentication automatically and can omit this header.
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
このサーバーは、ツール一覧を表示する前にサインインを求めます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月10日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名はドメイン cairn.ink で確認済みです(レジストリがドメインの所有を確認しています)
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- ✓ 合格
エンドポイントが応答する
242ミリ秒で応答(HTTP 401)
- ✓ 合格
OAuthでサインイン
OAuthでのサインインに対応しているため、AIアプリがログイン画面へ案内してくれます
- … 未チェック
ツールの説明に隠れた指示がない
まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります
検索・AIの記憶のほかのサーバーとの比較i
- このカテゴリのほかの5832件のうち0%よりスターが多い
- このカテゴリのほかの5832件のうち47%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの5832件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Cairn.ink Memoryは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:Authorization
パソコンで動きますか、それともクラウドですか?
作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は–、最新バージョン(0.1.0)がレジストリに届いたのは先月です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。
代わりに使えるものは?
同じカテゴリには:Context7, Codebase Memory, Exa
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Codebase Memory
Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.
Exa
Connect AI agents to Exa for web search, content fetching, and multi-step research.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
Cairn Memory
Keep important context between AI sessions. Change it when things change.
English · 繁體中文
See an example · Where to start · Local setup · Hosted setup · Limitations · Privacy
Cairn Memory is Cairn.ink's open-source AI memory toolkit for Claude Code and Codex, with local MCP tools or cloud automatic memory. Visit Cairn.ink, install @cairn-ink/memory on npm, or view the Cairn Memory GitHub repository.
Starting a new AI session often means repeating your preferences and project decisions. Cairn provides memory tools to save that context between sessions, inspect the submitted text behind each memory, and update it when things change.
A preference changes
Suppose you save “Keep my reports short.” Later, you decide you need detailed reports. You can inspect the old memory and its source text, correct the saved preference, or forget it so it is no longer available for active recall.
This is an illustrated explicit-tool example, not a chat-client screenshot. The local preview uses tools to save, inspect, correct and forget; it does not automatically read your conversations.
- Inspect the source. Read the source text stored with a memory. A receipt does not prove that the memory is true or correctly interpreted.
- Correct what changed. Update the memory at the revision you inspected.
- Forget what should go. Remove a memory from active recall. Deletion and backup boundaries apply.
A Source Receipt is the submitted text attached to a memory. It helps you check what was supplied when the memory was saved or corrected. It is not a verified transcript of the whole conversation or proof of human intent.
Cairn Memory and Cairn
Cairn Memory is the open-source toolkit in this repository for saving, inspecting and changing AI memory. [Cairn](https://cairn.ink) is the hosted shared memory map for people and AI, where people organize, review and share knowledge.
This repository includes local memory tools and connectors to the hosted Cairn service. Each path has its own setup and feature boundaries. Local use does not require a Cairn account; hosted connections require a compatible service and authentication.
Choose your starting point
| You want to… | Start here | What you need |
|---|---|---|
| Understand the idea before installing | 繁體中文 or the recorded walkthrough | No installation or account |
| Try the open-source tools on your computer | Local preview setup or Windows guide | Terminal setup; Linux x64 and a bounded native Windows x64 check; no Cairn account |
| Use the documented hosted Claude Code or Codex connection | Hosted setup | A compatible hosted service and authentication; separate from local-preview client support |
| Build on the memory layer | Architecture and MCP tools | JavaScript or MCP integration work |
If you use Claude or Codex but do not usually install tools from a terminal, start with the example and recorded walkthrough. This preview requires setup; check the tested client paths before connecting your AI tool.
Current preview
Cairn's open-source memory layer stores memories in your own SQLite file and exposes them through MCP or JavaScript. No Cairn account is needed for local use.
Developer preview. Installed persistence and a narrow real-model memory loop have retained evidence. Default extraction still fails our source-support bar; see known limitations. Save, inspect, correct and forget work without a model key. Semantic recall requires your OpenAI key and sends selected context to that provider.
Watch the recorded walkthrough
Watch the 36-second model-free demo (MP4). This records the memory tools running, rather than a conversation in Claude or Codex. “Model-free” means no AI model is called during the walkthrough.
For long-conversation results, see the four-case real-model pilot. It is an opt-in diagnostic with one failed Cairn answer, not a measurement of long-term default-client recall reliability. Known limitations
Open the recorded tool walkthrough (GIF)
The demo below records the model-free loop: save, restart, inspect, correct and forget. Its recall step reports model_not_configured.
Recorded responses and regeneration instructions · Verified capabilities and client support
Install
For Claude Code and Codex, run the one-command installer:
npx @cairn-ink/memory setup
A fresh interactive install asks once: local MCP memory tools on this computer, or cloud automatic memory with cairn.ink sign-in; choose directly with setup --local or setup --cloud. Fresh non-interactive runs need --local or --cloud; local mode has no automatic capture or recall in 0.6.3.
Installer 0.6.3, with Codex 0.164.0–0.166.0 format requalification, was published on 2026-11-03, so npx @cairn-ink/memory setup uses it; a checkout can also run node packages/setup/bin/memory.mjs setup. The plugin is 0.3.3. Requires Node ≥22.16 and at least one CLI on PATH. Cloud setup asks about new tools, updates connected tools, and uses one browser sign-in when connecting both. The default server is cairn.ink. Conflicting servers or memory IDs present a choice; non-interactive conflicts change nothing. Codex must pass format qualification before automatic memory is enabled. Automated codex exec runs skip capture and prompt recall by default; opt in with npx @cairn-ink/memory config --codex-capture-exec on.
Choose the mode that fits your workflow:
- [Local preview](#try-the-local-memory-layer): your SQLite database, explicit MCP memory tools, no Cairn account. Start here to try the open-source memory layer. Semantic recall uses your OpenAI key.
- [Hosted integration](#existing-hosted-integration): memory on cairn.ink, with automatic capture and recall through the Claude Code plugin. Requires a Cairn account, token and compatible service. Explicit hosted MCP is also available.
Try the local memory layer
Prerequisites: Git, Node >=22.16, npm and `tar`. Recorded checks cover Linux x64 and a bounded native Windows x64 installation. On Windows, use the [PowerShell setup and walkthrough](docs/windows-install.md); the commands below use Linux/WSL paths. Other platforms are unverified. Install from this repository: the unscoped npm and PyPI packages named cairn-memory are unrelated projects. The local archive is not published to npm yet.
1. Install into a new directory. Replace the path below with a new absolute directory beneath an existing parent you control.
git clone https://github.com/Cairn-ink/cairn-memory.git
cd cairn-memory npm run install:preview -- --directory /absolute/new/cairn-local --owner local-user
The installer builds this checkout and downloads pinned public npm dependencies without install scripts. It creates app/, data/ and a private installation-receipt.json containing the executable path and MCP settings. It makes no model calls. Keep the receipt private: it contains local paths and identity. Installation details, recovery and backup
2. Run the model-free check. From the source checkout, use the same installation path. No chat-client setup or model key is needed.
npm ci --prefix adapters/mcp
node adapters/mcp/walkthrough.mjs --executable /absolute/new/cairn-local/app/node_modules/.bin/cairn-memory
Expect status: "passed". The check uses a fresh synthetic database and verifies the five tools, receipts, process-restart persistence, correction and forgetting. It strips the model key from the child process; model_not_configured is the expected recall result. Steps and expected results
3. Connect a client. Copy stdio.command and stdio.args from your private installation receipt into the client's local MCP configuration. Keep the same database, owner and project across sessions. See the tested client matrix.
For semantic recall, explicitly supply OPENAI_API_KEY through the MCP process's secret environment. The walkthrough's optional --with-recall path sends synthetic context to OpenAI and incurs model charges; it has no built-in dollar cap. A fully local model path is not yet verified.
For the Hermes native provider, follow its separate setup guide. It uses a profile-local database and owner, plus CAIRN_MEMORY_OPENAI_API_KEY, rather than the generic MCP settings above.
| Tool | Purpose |
|---|---|
remember_memory | Explicitly save one memory and its receipt |
recall_memory | Model-guided retrieval of current memories and receipts |
inspect_memory | List memories, or inspect an ID, revision and receipts |
correct_memory | Replace content at the revision you inspected |
forget_memory | Logically delete at the revision you inspected |
The default local server exposes explicit tools. For opt-in submitted-message capture, project scope and configuration checks, see the installed preview guide. The full evidence and limitations cover extraction failures, long-history retrieval and the boundaries of individual client tests.
Local privacy and control
- Memory, receipts and organization persist in your selected SQLite database. No Cairn account, hosted service or hidden core telemetry is required.
- MCP does not read transcripts or save whole conversations automatically. Receipt text records a tool assertion; it is not proof of authenticated human intent.
- Model processing is cloud processing when configured. Redaction is best-effort, not a guarantee that all secrets are removed. Retrieved text is untrusted data, never instructions to follow.
- Forgetting prevents active recall and exact normalized re-admission; paraphrases can still be
冒頭だけを表示しています。続きはリポジトリで読めます