Rushdb Memory Layer For Ai Agents And Apps

RushDB MCP 服务

通过 MCP 为你的 Agent 添加记忆层。

将 RushDB 连接到任意兼容 MCP 的 AI 客户端，即可为你的 Agent 增添持久化、结构化记忆，支持语义搜索和图遍历，无需管理嵌入或架构。

适用于 ChatGPT、Claude.ai、Claude Desktop、Cursor、Windsurf、Gemini CLI，以及任意兼容 MCP 的工具。

---

两种连接方式

远程 OAuth（无需安装）

适用于 ChatGPT、Claude.ai 和其他基于 Web 的 AI 客户端——直接连接，无需在本地安装任何内容：

MCP 端点： https://mcp.rushdb.com/mcp

客户端会将你重定向至 RushDB 进行 OAuth 登录，并获取受限令牌。无需设置 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. 完成。**现在，Agent 可以使用 13 个工具来存储、查询和遍历结构化记忆。

RUSHDB_API_URL 为可选项，默认值为 https://api.rushdb.com/api/v1。可在可自托管或暂存环境中覆盖此值。

---

Agent 可以做什么

连接后，可以像平常一样向 Claude 或你的 Agent 提问：

“请记住，我们决定在 2026-04-10 使用 Clerk 进行身份验证，取代 Auth0。”

Agent 会调用 CreateRecord 来存储结构化记忆。之后可以问：

“我们做过哪些身份验证方面的决策？”

Agent 会使用语义查询调用 FindRecords，无需手动搜索。

“显示所有与身份验证系统相关的内容。”

Agent 会调用 FindRelationships，遍历相连记录组成的图。

---

可用工具

发现

工具	功能
FindLabels	列出记录标签和记录数量
FindProperties	列出各标签下的属性
FindRelationships	搜索记录之间的关系

记录

工具	功能
CreateRecord	存储新记录
GetRecord	按 ID 获取记录
UpdateRecord	更新现有记录
DeleteRecord	按 ID 删除记录
FindRecords	按属性、关系或语义查询搜索记录
BulkCreateRecords	一次创建多条记录
BulkDeleteRecords	删除符合查询条件的记录

关系

工具	功能
AttachRelation	在两条记录之间创建关系
DetachRelation	移除关系
ListRelationshipPatterns	列出推断出的关系模式和分析状态
AnalyzeRelationshipPatterns	将关系建议的架构分析加入队列
ApproveRelationshipPattern	批准并应用建议的模式
IgnoreRelationshipPattern	忽略建议的模式
DeleteRelationshipPattern	删除已保存的模式，并可选择删除其物化关系

实用工具

工具	功能
ExportRecords	将记录导出为 CSV
HelpAddToClient	获取 MCP 客户端的设置说明
GetQueryBuilderPrompt	返回内置的查询构建器系统提示词（适用于不支持 MCP Prompts 的客户端）

---

内置查询构建器提示词

RushDB 通过 MCP Prompts API 提供系统提示词，指导 Agent 安全地进行查询——先发现标签和属性，再构建查询。

工作方式：

1. 客户端调用 ListPrompts → 查找 rushdb.queryBuilder
2. 客户端调用 GetPrompt → 将其注入为会话系统消息
3. Agent 随后会自动优先执行发现操作，再进行查询

大多数 MCP 客户端会在会话开始时处理这一流程。如果你的客户端不支持 MCP Prompts，请调用 GetQueryBuilderPrompt，并将结果注入为系统消息。

---

环境变量

这些变量仅适用于本地（API 密钥）模式。远程 OAuth 连接不使用环境变量。

变量	必需	说明
RUSHDB_API_KEY	是	你的 RushDB API 密钥
RUSHDB_API_URL	否	API 基础 URL（默认：https://api.rushdb.com/api/v1）

---

Registry 和自动发现

• 仓库根目录下的 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 客户端在此 monorepo 内的某个工作目录中启动服务时，才会发生此问题（例如，Claude Code / Cursor 使用位于仓库根目录的 .mcp.json）。@rushdb/mcp-server 在此处是一个 pnpm 工作区包，因此，任何未指定版本的 npx @rushdb/mcp-server（即使带有 -p）都会解析到本地工作区副本，而该副本的 rushdb-mcp 可执行文件未链接到 node_modules/.bin。进程会在 MCP 握手前退出，客户端会将其报告为 -32000。

已发布的包不受影响——在仓库之外，上述配置可以直接使用。若要在 monorepo 内运行，请固定版本，让 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