Rushdb Memory Layer For Ai Agents And Apps

RushDB MCP サーバー

MCP を介して、エージェントにメモリ層を提供します。

RushDB を MCP 対応の AI クライアントに接続すると、エージェントに永続的で構造化されたメモリが備わります。埋め込みやスキーマを管理する必要はなく、意味検索やグラフのたどり込みが可能です。

ChatGPT、Claude.ai、Claude Desktop、Cursor、Windsurf、Gemini CLI、および MCP 対応のあらゆるツールで動作します。

---

接続方法は 2 つあります

リモート OAuth（インストール不要）

ChatGPT、Claude.ai、その他のウェブベースの AI クライアントでは、ローカルに何もインストールせずに直接接続できます。

MCP エンドポイント： https://mcp.rushdb.com/mcp

クライアントは OAuth サインインのために RushDB へリダイレクトし、スコープ付きトークンを受け取ります。API キーの設定は不要です。

ChatGPT：

1. Settings → Connectors → Add connector に移動します
2. https://mcp.rushdb.com/mcp を入力します
3. RushDB アカウントでサインインします

Claude.ai：

1. Settings → Integrations → Add integration に移動します
2. https://mcp.rushdb.com/mcp を入力します
3. RushDB アカウントで認証します

---

ローカル（API キー）

Claude Desktop、Cursor、Windsurf、VS Code、その他の stdio MCP クライアント向けです。

1. API キーを取得します。app.rushdb.com で取得できます。

2. MCP クライアントの設定に追加します：

{
  "mcpServers": {
    "rushdb": {
      "command": "npx",
      "args": ["@rushdb/mcp-server"],
      "env": {
        "RUSHDB_API_KEY": "your-api-key-here"
      }
    }
  }
}

次の場所に配置します。

• Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor — Cursor 設定パネルの MCP 設定
• Windsurf — ~/.codeium/windsurf/mcp_config.json

3. これで完了です。 エージェントは、構造化メモリの保存、検索、たどり込みに使える 13 個のツールを利用できるようになります。

RUSHDB_API_URL は省略可能で、デフォルトは https://api.rushdb.com/api/v1 です。セルフホスト環境やステージング環境では、値を上書きしてください。

---

エージェントにできること

接続後、Claude やエージェントに自然な言葉で依頼できます。

「2026-04-10 に Auth0 を置き換えて、認証に Clerk を使うと決めたことを覚えておいてください。」

エージェントは CreateRecord を呼び出して、構造化されたメモリを保存します。その後、次のように尋ねます。

「認証について、どのような決定をしましたか？」

エージェントは意味クエリで FindRecords を呼び出すため、手動で検索する必要はありません。

「認証システムに関連するものをすべて見せてください。」

エージェントは FindRelationships を呼び出して、関連するレコードのグラフをたどります。

---

利用可能なツール

検出

ツール	説明
FindLabels	レコードのラベルとレコード数を一覧表示します
FindProperties	ラベル全体のプロパティを一覧表示します
FindRelationships	レコード間の関係を検索します

レコード

ツール	説明
CreateRecord	新しいレコードを保存します
GetRecord	ID を指定してレコードを取得します
UpdateRecord	既存のレコードを更新します
DeleteRecord	ID を指定してレコードを削除します
FindRecords	プロパティ、関係、または意味クエリでレコードを検索します
BulkCreateRecords	複数のレコードを一度に作成します
BulkDeleteRecords	クエリに一致するレコードを削除します

リレーションシップ

ツール	機能
AttachRelation	2つのレコード間にリレーションシップを作成します
DetachRelation	リレーションシップを削除します
ListRelationshipPatterns	推測されたリレーションシップパターンと分析状況を一覧表示します
AnalyzeRelationshipPatterns	リレーションシップの提案に向けてスキーマ分析をキューに追加します
ApproveRelationshipPattern	提案されたパターンを承認して適用します
IgnoreRelationshipPattern	提案されたパターンを無視します
DeleteRelationshipPattern	保存されたパターンを削除し、任意で、そのパターンから作成されたリレーションシップも削除します

ユーティリティ

ツール	機能
ExportRecords	レコードを CSV にエクスポートします
HelpAddToClient	MCP クライアントのセットアップ手順を取得します
GetQueryBuilderPrompt	組み込みのクエリビルダー用システムプロンプトを返します（MCP Prompts に対応していないクライアント向けのフォールバック）

---

組み込みのクエリビルダープロンプト

RushDB は MCP Prompts API を通じてシステムプロンプトを公開し、安全なクエリ方法をエージェントに教えます。まずラベルとプロパティを確認し、その後クエリを作成します。

仕組み：

1. クライアントが ListPrompts を呼び出す → rushdb.queryBuilder を見つけます
2. クライアントが GetPrompt を呼び出す → セッションのシステムメッセージとして挿入します
3. エージェントは自動的に、確認を先に行うクエリを実行するようになります

ほとんどの MCP クライアントは、セッション開始時にこの処理を行います。クライアントが MCP Prompts に対応していない場合は、GetQueryBuilderPrompt を呼び出し、結果をシステムメッセージとして挿入してください。

---

環境変数

これらはローカル（API キー）モードにのみ適用されます。リモート OAuth 接続では環境変数を使用しません。

変数	必須	説明
RUSHDB_API_KEY	はい	RushDB API キー
RUSHDB_API_URL	いいえ	API ベース URL（デフォルト：https://api.rushdb.com/api/v1）

---

レジストリと自動検出

• リポジトリのルートにある mcp.yaml により、MCP レジストリでの自動検出が有効になります
• packages/mcp-server/glama.json には Glama のメタデータが含まれています
• パッケージ：@rushdb/mcp-server、コマンド：npx

---

開発

git clone https://github.com/rush-db/rushdb
cd rushdb/packages/mcp-server
npm install
npm run build

トラブルシューティング：rushdb-mcp: command not found / MCP エラー -32000

この問題は、MCP クライアントがこのモノレポ内の作業ディレクトリからサーバーを起動した場合にのみ発生します（例：リポジトリのルートにある .mcp.json を Claude Code / Cursor で使用する場合）。ここでは @rushdb/mcp-server は pnpm ワークスペースのパッケージであるため、バージョンを指定しない npx @rushdb/mcp-server（-p を付けた場合も含む）はローカルのワークスペースのコピーを解決します。このコピーの rushdb-mcp バイナリは node_modules/.bin にリンクされていません。MCP ハンドシェイクの前にプロセスが終了し、クライアントには -32000 として報告されます。

公開済みパッケージには影響しません。上記の設定は、リポジトリ外部ではそのまま動作します。モノレポ内から実行するには、バージョンを固定して、npx がワークスペースのパッケージではなくレジストリから取得するようにしてください：

{
  "mcpServers": {
    "rushdb": {
      "command": "npx",
      "args": ["-y", "-p", "@rushdb/mcp-server@latest", "rushdb-mcp"],
      "env": { "RUSHDB_API_KEY": "your-api-key-here" }
    }
  }
}

または、ローカルのビルドを直接実行してください（リポジトリ内のコードを使用します。先に npm run build でビルドする必要があります）：

{
  "mcpServers": {
    "rushdb": {
      "command": "node",
      "args": ["packages/mcp-server/build/index.js"],
      "env": { "RUSHDB_API_KEY": "your-api-key-here" }
    }
  }
}

---

ライセンス

Apache 2.0