Mentedb MCP

MenteDB MCP服务器

贝塔 --MenteDB正在积极开发中。API可能会在次要版本之间发生变化。

MenteDB的MCP（模型上下文协议）服务器，人工智能代理的思维数据库。


这是什么？

此MCP服务器允许任何AI代理（Claude、GPT、Copilot或任何兼容MCP的客户端）使用MenteDB作为持久内存。默认情况下，它连接到MenteDB Cloud——没有本地数据库，没有文件锁，可以同时跨多个会话工作。

快速开始

在一个命令中安装和配置：

npx mentedb-mcp@latest setup copilot

然后进行身份验证：

npx mentedb-mcp@latest login

就是这样。您的代理现在拥有持久内存，可以在您的所有会话和设备上运行。替换 copilot 和 cursor 或 claude 对于其他编辑。

运作原理

登录后，MCP服务器将作为瘦HTTP客户端运行——所有内存操作（存储、搜索、调用）都由MenteDB Cloud处理。这意味着：

• 没有本地数据库锁
• 多个编辑器会话可以同时运行
• 设备间的内存自动同步
• 嵌入和提取在服务器端处理（不需要本地GPU）

本地模式（离线/自托管）

如果你更喜欢在没有云的情况下完全离线运行：

mentedb-mcp --local

在本地模式下，服务器在以下位置使用嵌入式数据库 ~/.mentedb/。由于文件锁定，一次只能运行一个实例。

替代方案：从源代码安装

如果你更喜欢从源代码而不是npx构建：

cargo install mentedb-mcp
mentedb-mcp setup copilot
mentedb-mcp login

更新

升级后，服务器启动时指令会自动更新。要手动查看和确认更改，请执行以下操作：

mentedb-mcp update copilot

这 update 命令显示将要编写的确切指令并要求确认。如果您自定义了MenteDB块，它会警告您并创建一个 .bak 备份。您在MenteDB块之外的指令始终会被保留。

CLI命令

认证

npx mentedb-mcp@latest login

这将打开浏览器以授权CLI。一旦通过身份验证，凭据将保存到 ~/.mentedb/cloud.json MCP服务器在后续运行中连接到MenteDB Cloud。

要检查您的连接：

npx mentedb-mcp@latest status

要撤销访问权限，请执行以下操作：

npx mentedb-mcp@latest logout

您还可以从web仪表板中撤销会话，网址为 app.mentedb.com.

手动配置

克劳德桌面

添加 ~/.config/claude/claude_desktop_config.json （macOS/Linux）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "mentedb": {
      "command": "npx",
      "args": ["-y", "mentedb-mcp@latest"]
    }
  }
}

光标

添加到光标MCP配置中：

{
  "mcpServers": {
    "mentedb": {
      "command": "npx",
      "args": ["-y", "mentedb-mcp@latest"],
      "transportType": "stdio"
    }
  }
}

GitHub Copilot 命令行工具

添加 ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "mentedb": {
      "command": "npx",
      "args": ["-y", "mentedb-mcp@latest"],
      "alwaysAllow": [
        "process_turn", "store_memory", "search_memories", "forget_memory"
      ]
    }
  }
}

这 alwaysAllow 列表允许内存工具在没有批准提示的情况下运行。

工具

默认情况下，服务器公开了4个基本工具：

什么 process_turn 回报

自动浓缩

当配置LLM提供者时， process_turn 自动触发背景富集管道，随着时间的推移增强您的内存图：

丰富是 全自动 --除了设置LLM提供程序外，不需要其他工具或配置。结果直接反馈到未来 process_turn 上下文检索，随着时间的推移提高回忆质量。

通过环境变量配置LLM提供程序：

# OpenAI (recommended)
export MENTEDB_OPENAI_API_KEY=sk-...

# Or Anthropic
export MENTEDB_ANTHROPIC_API_KEY=sk-ant-...

# Or Ollama (local, no key needed)
export MENTEDB_LLM_PROVIDER=ollama

如果没有LLM提供者，MCP服务器可以完美工作——丰富功能根本无法运行。

内存类型

内存作用域

集 scope: 'always' 当用户说“永远记住这一点”或陈述一个硬约束时。

内存质量指南

• 每个记忆一个事实 --不要把无关的事实放在一个记忆中
• 自足 --“在Python中，用户更喜欢制表符而不是空格”，而不仅仅是“喜欢制表符”
• 包括上下文 --“对于mentedb-mcp，使用…进行部署”，而不仅仅是“使用…部署”
• 200字以内 --必要时进行总结
• 不要储存 --问候语、临时信息、大代码块、聊天

韧性

即使 process_turn 转弯失败或出错，下次转弯时一定要再次呼叫。永远不要因为之前的失败而跳过。

本地模式：全工具(--full-tools)

在本地模式下(--local)，您可以通过以下方式公开所有32个工具 --full-tools 用于高级内存操作，包括知识图遍历、整合、认知系统和GDPR遗忘。

配置

CLI参数

mentedb-mcp [OPTIONS]

Options:
  --local                     Force local mode (embedded database, single instance)
  --data-dir 
           Data directory path [default: ~/.mentedb]
  --embedding-dim        Embedding vector dimension [default: 128]
  --llm-provider 
   LLM provider for local extraction: openai, anthropic, ollama, mock [default: mock]
  --llm-api-key          API key for the LLM provider (overrides env var)
  --llm-model          Model name override for the LLM provider
  --full-tools                Expose all 32 tools (local mode only, default: 4 essential tools)
  -h, --help                  Print help

环境变量

服务器将日志写入stderr和位于的滚动文件 ~/.mentedb/mentedb-mcp.log.

建筑

云模式（默认）： 服务器在stdio传输上作为轻量级HTTP代理运行。所有内存操作都转发到MenteDB Cloud，后者处理嵌入生成（通过AWS Bedrock Titan）、语义搜索、LLM提取（通过Claude）和DynamoDB存储。没有地方州被保留。

本地模式(--local): 服务器使用带有嵌入式fjall数据库的完整MenteDB引擎、本地Candle嵌入（全MiniLM-L6-v2）和可选的LLM提取。该模式支持所有32种工具，包括知识图谱、整合和认知系统。

问题

发现错误或有功能请求？ 提出问题.

许可证

阿帕奇-2.0