Ratary Memory MCP

Name: Ratary Memory MCP
Author: ontorata

作者：ontorataバージョン 1.1.1i★ –iパソコンで動く

レジストリ名io.github.ontorata/ratary

インストール

概要

作者による説明（英語の原文）

Persistent coding memory for AI assistants. MCP stdio, hybrid search, graph, context.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: 検索・AIの記憶
入力が必要なもの：RATARY_API_KEY

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： RATARY_API_KEY, RATARY_BASE_URL

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "ratary": {
      "command": "npx",
      "args": [
        "-y",
        "@ratary/mcp-server"
      ],
      "env": {
        "RATARY_API_KEY": "your-value",
        "RATARY_BASE_URL": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add ratary --env RATARY_API_KEY=your-value --env RATARY_BASE_URL=your-value -- npx -y @ratary/mcp-server

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "ratary": {
      "command": "npx",
      "args": [
        "-y",
        "@ratary/mcp-server"
      ],
      "env": {
        "RATARY_API_KEY": "your-value",
        "RATARY_BASE_URL": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "ratary": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ratary/mcp-server"
      ],
      "env": {
        "RATARY_API_KEY": "your-value",
        "RATARY_BASE_URL": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

RATARY_API_KEY 秘密必須 env
Ratary API key (aic_...)
RATARY_BASE_URL env
Ratary REST base URL (default https://ratary.ontorata.com)

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント ontorata で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

検索・AIの記憶のほかのサーバーとの比較i

このカテゴリのほかの7259件のうち0%よりスターが多い
このカテゴリのほかの7259件のうち20%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの7259件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Ratary Memory MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：RATARY_API_KEY

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（1.1.1）がレジストリに届いたのは4 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Context7, Codebase Memory, Exa

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Context7

作者：upstash

Up-to-date docs for AI agents

パソコンでもクラウドでも★ 64,224MIT昨日更新

インストール

Codebase Memory

作者：DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

パソコンで動く★ 48,148MIT20 日前更新

インストール

Exa

作者：exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

クラウドで動く★ 5,213MIT先月更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Ratary

Build AI that remembers.

Ratary is the open-source AI Brain Platform — persistent memory,

structured knowledge, and intelligent retrieval for every model and agent you run.

Get started → · Star on GitHub · Website · Docs

Ratary is where AI remembers. · Built by Ontorata

Quick start · Ecosystem · Architecture · How it works · Capabilities · Docs

The problem

*Why does AI forget between sessions?*

Every AI session starts from zero.

Your model forgets yesterday's architecture decisions. Your agent drops customer context between runs. Your coding assistant can't recall why you chose Postgres over DynamoDB. Teams paste the same background into Cursor, Claude, ChatGPT, and custom bots — and knowledge still drifts.

Vector databases store chunks. RAG pipelines retrieve documents. Agent frameworks orchestrate tools.

None of them give AI a durable brain.

Why Ratary exists

*Why build a brain layer now?*

AI models are getting cheaper. Context windows are getting larger. Agents are getting capable.

But AI still forgets.

The bottleneck is no longer reasoning. It's memory — durable, structured, retrievable, and owned by you.

Every serious application eventually needed a database. Every serious AI system will need a brain layer: persistent intelligence that sits between your models and your storage — independent of any single vendor, IDE, or agent framework.

AI should remember.

Developers should own that memory.

Ratary exists to be that layer. Applications bring models. Ratary brings the brain.

What Ratary is

*What is Ratary?*

Ratary is an AI Brain Platform — infrastructure that gives AI:

Persistent memory — durable, owner-scoped, versioned
Structured knowledge — metadata, relations, graph traversal
Intelligent retrieval — hybrid search + bounded context assembly
Protocol access — Ratary MCP, REST, optional gRPC

It sits between AI clients and storage. One brain, many surfaces — Cursor, Claude Code, custom agents, enterprise APIs, and remote MCP hosts.

The runnable deployment is [Ratary Server](#quick-start) — this repository. Ratary is the product; Ratary Server is what you clone and run.

Bring your model. Ratary brings the memory.

Quick start

*How do I run Ratary Server locally?*

Ratary is the product. Ratary Server is the open-source deployment you run — ontorata/ratary (this repository). @ratary/sdk, @ratary/cli, and Ratary MCP connect to it; sibling Ontorata products use the same source of truth.

Prerequisites: Node.js 24 · SQL metadata store (pick one — Postgres is the template default)

Path A — PostgreSQL (npm + local or Docker)

git clone https://github.com/ontorata/ratary.git

cd ratary && npm install cp .env.example .env # Set AUTH_SECRET + DATABASE_URL — see .env.example QUICK START npm run db:apply-postgres-schema npm run setup # wire Ratary MCP for Cursor, Claude Code, … npm run dev

Or use Docker: docker compose --profile postgres up --build — see docs/DOCKER.md.

Path B — Cloudflare D1

git clone https://github.com/ontorata/ratary.git

cd ratary && npm install cp .env.example .env # Set AUTH_SECRET + SQL_PROVIDER=d1 + CLOUDFLARE_* / D1_* npm run db:migrate npm run setup npm run dev

Details: [docs/GUIDE.md](docs/GUIDE.md#1-setup) · [docs/CONFIGURATION.md](docs/CONFIGURATION.md)

→ API http://localhost:9876 · Swagger /docs

First REST call: bootstrap once to get an API key (aic_...) — see GUIDE — First REST API key.

# Save your first memory

curl -X POST http://localhost:9876/api/v1/memory \ -H "Authorization: Bearer aic_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"title":"Hello brain","project":"demo","content":"Ratary remembers this."}'

Full guide: [docs/GUIDE.md](docs/GUIDE.md) · SDK & MCP examples in docs/examples/

npm packages (`@ratary`)

Client libraries ship on npm under the `@ratary` scope — product name, published by Ontorata. No server clone required for SDK, CLI, or hosted MCP.

npm install @ratary/sdk@1.1.0

npx @ratary/mcp-server@1.1.3 # remote REST → stdio MCP npm install -g @ratary/cli@1.1.0 # operator CLI

Package	Version	Install	Role
`@ratary/sdk`	1.1.0	`npm install @ratary/sdk`	Typed REST client + `client.admin.*`
`@ratary/cli`	1.1.0	`npm install -g @ratary/cli`	Operator commands (`admin`, `connectors`)
`@ratary/mcp-server`	1.1.3	`npx @ratary/mcp-server`	IDE MCP → hosted API

Set RATARY_BASE_URL and RATARY_API_KEY (aic_...). Details: [packages/README.md](packages/README.md) · remote MCP install.

Ecosystem

*Which repository owns what?*

The Visual architecture diagram shows logical layers inside Ratary Server. This diagram shows repository and product relationships — what ships in this repo, what connects to it, and what lives in sibling Ontorata repositories. Both views describe the same platform from different angles.

Throughout this README, Ratary MCP means the official memory MCP implementation (stdio in this repo · npm @ratary/mcp-server for hosted REST). It is not the same as Ontorata MCP (ecosystem gateway — separate repo).

┌─────────────────────────────────────────────────────────────┐

│ Ratary Cloud (opt-in) │ │ optional hosted deployment · not this repo │ └──────────────────────────────┬──────────────────────────────┘ │ ┌──────────────────────────────▼──────────────────────────────┐ │ Ratary Server ← ontorata/ratary (this repo) │ └──────────────────────────────┬──────────────────────────────┘ │ │ │ ▼ ▼ ▼ @ratary/sdk @ratary/cli @ratary/mcp-server (SDK) (CLI) (Ratary MCP · npm) │ │ │ └──────────────┴──────────────┘ │ ┌─────────────────────┴─────────────────────┐ ▼ ▼ ▼ Ontorata MCP Ontorata Studio Ontory Runtime ontorata/ontorata-mcp ontorata/Ontorata-Studio ontorata/ontory-runtime ecosystem product ecosystem product (ADR-2119; was ontorata/ontory)

Infrastructure (ships from ontorata/ratary — server plus client packages):

Component	Repository	Role
Ratary Server	ontorata/ratary	Memory engine — REST, persistence, Ratary MCP stdio. You run this.
Ratary SDK	npm `@ratary/sdk` · `packages/sdk`	Typed REST client for Ratary Server.
Ratary CLI	npm `@ratary/cli` · `packages/cli`	Operator commands; delegates to Ratary SDK.
Ratary MCP	npm `@ratary/mcp-server` · stdio in repo	Memory MCP — full stdio in clone · npm proxy for hosted REST.

Ecosystem products (separate repositories — connect to Ratary Server; not bundled here):

Product	Repository	Role
Ontorata MCP	ontorata/ontorata-mcp	Ecosystem MCP gateway — Ratary MCP plus additional Ontorata tools.
Ontorata Studio	ontorata/Ontorata-Studio	Operator UI — uses `@ratary/sdk` only.
Ontory	ontorata/ontory-runtime	Ontory Runtime — AI orchestration (ADR-2119). Legacy URL `ontorata/ontory` redirects.

Ratary Server does not depend on ecosystem product repositories.

Ratary MCP vs Ontorata MCP

*Which MCP should I install?*

	Ratary MCP	Ontorata MCP
Layer	Ratary infrastructure	Ontorata ecosystem product
What it is	Official memory protocol for Ratary Server	Ecosystem gateway for Ontorata products
Scope	Memory — CRUD, search, context, graph	Ratary memory plus additional Ontorata tools
Repository	ontorata/ratary · npm `@ratary/mcp-server`	ontorata/ontorata-mcp
Typical `mcp.json` key	`ratary`	`ontorata`

Use Ratary MCP for direct memory access. Use Ontorata MCP for one MCP entry point across the Ontorata stack. Both use Ratary Server as source of truth.

What Ratary is not

*How is Ratary different from alternatives?*

	Vector DB	Memory API	RAG	Agent framework	Ratary
Primary job	Similarity search	Key-value recall	Document Q&A	Tool orchestration	Durable AI memory
Structured knowledge & graph	❌	⚠️	❌	⚠️	✅
MCP-native IDE integration	❌	⚠️	❌	⚠️	✅
Token-efficient context assembly	❌	⚠️	❌	⚠️	✅
Self-host & data sovereignty	✅	⚠️	⚠️	⚠️	✅
Clear agent boundary	N/A	⚠️	N/A	❌ bundled	✅ substrate only

Ratary complements your stack — it does not replace pgvector, LangGraph, or your agent of choice. See the [Capability matrix](#capability-matrix) for a feature-level comparison.

Why not just pgvector, Mem0, Letta, LangGraph, or RAG?

If you only use…	You get…	What you miss
pgvector	Embedding similarity	Structured memory, graph, MCP, context packing

| Mem0 | Fast hosted memory API | Full self-host, hybrid retrie

冒頭だけを表示しています。続きはリポジトリで読めます

Ratary Memory MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

検索・AIの記憶のほかのサーバーとの比較i

よくある質問

代わりの候補

Context7

Codebase Memory

Exa

作者のREADME

The problem

Why Ratary exists

What Ratary is

Quick start

Path A — PostgreSQL (npm + local or Docker)

Path B — Cloudflare D1

npm packages (@ratary)

Ecosystem

Ratary MCP vs Ontorata MCP

What Ratary is not

npm packages (`@ratary`)