Nexmemory MCP

NexMemory MCP服务器

NexMemory的模型上下文协议服务器 *知识库和实体管理系统*

](https://www.npmjs.com/package/nexmemory-mcp) ](https://nodejs.org/) 

安装 • 配置 • 用法 • 特性

______________________________________________________________________

📋 目录

• 概述
• 特性
• 安装
• 配置

- 光标IDE - 克劳德桌面 - 帆板运动 - Visual Studio代码（VS代码） - - 泽德 - Continue.dev - 克莱恩 - Roo代码 - Zencoder - 源极图放大器

• 环境变量
• 可用工具
• 用法示例
• 故障排除
• 许可证

______________________________________________________________________

🎯 概述

NexMemory MCP Server是一个模型上下文协议（MCP）服务器，它提供了NexMemory知识库和AI驱动的开发环境之间的无缝集成。它使AI助手能够直接从您最喜欢的代码编辑器中创建、管理、搜索知识库中的实体并与之交互。

______________________________________________________________________

✨ 特性

• 🚀 零配置部署 通过 npx
• 🔌 通用兼容性 与所有主要的MCP客户
• 📝 完整的CRUD操作 对于实体
• 🔍 语义搜索 能力
• 🏷️ 基于标签的过滤 和组织
• ⚡ 实时集成 使用AI助手
• 🔐 安全的API密钥身份验证
• 📊 全面的实体管理

______________________________________________________________________

📦 安装

快速入门（推荐）

无需安装即可直接运行：

npx nexmemory-mcp

全球安装

npm install -g nexmemory-mcp

然后运行：

nexmemory-mcp

______________________________________________________________________

⚙️ 配置

环境变量

在配置MCP客户端之前，请设置以下环境变量：

______________________________________________________________________

🔧 MCP客户端配置

光标IDE

Cursor是一个内置MCP支持的AI驱动代码编辑器。

配置步骤

1. 查找配置文件：

- 项目特定: .cursor/mcp.json 在项目根目录中 - 全球: ~/.cursor/mcp.json

1. 添加配置：

{
  "mcpServers": {
    "nexmemory": {
      "command": "npx",
      "args": [
        "-y",
        "nexmemory-mcp"
      ],
      "env": {
        "NEXMEMORY_API_KEY": "your-api-key-here",
        "NEXMEMORY_API_URL": "http://localhost:3000/api",
        "DEBUG": "false"
      }
    }
  }
}

1. 重新启动游标 以应用更改。

______________________________________________________________________

克劳德桌面

Claude Desktop提供全面的MCP支持和深度集成功能。

配置步骤

1. 查找配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

1. 添加配置：

{
  "mcpServers": {
    "nexmemory": {
      "command": "npx",
      "args": [
        "-y",
        "nexmemory-mcp"
      ],
      "env": {
        "NEXMEMORY_API_KEY": "your-api-key-here",
        "NEXMEMORY_API_URL": "http://localhost:3000/api"
      }
    }
  }
}

1. 重新启动克劳德桌面 加载新配置。

______________________________________________________________________

帆板运动

Windsurf是一个内置MCP支持和AI Flow系统的AI原生IDE。

配置步骤

1. 查找配置文件：

- ~/.codeium/windsurf/mcp_config.json

1. 添加配置：

{
  "mcpServers": {
    "nexmemory": {
      "command": "npx",
      "args": [
        "-y",
        "nexmemory-mcp"
      ],
      "env": {
        "NEXMEMORY_API_KEY": "your-api-key-here",
        "NEXMEMORY_API_URL": "http://localhost:3000/api"
      }
    }
  }
}

1. 重新启动Windsurf 以应用更改。

______________________________________________________________________

Visual Studio代码（VS代码）

VS Code通过各种扩展支持MCP。选择最适合您工作流程的一个。

选项1：使用VSCode MCP桥扩展

1. 安装扩展：

- 在VS代码扩展市场中搜索“VSCode MCP Bridge” - 由YuTengjing安装扩展

1. 配置MCP服务器：

- 创建 .vscode/mcp.json 在您的工作空间中：

{
  "servers": {
    "nexmemory": {
      "command": "npx",
      "args": ["-y", "nexmemory-mcp"],
      "env": {
        "NEXMEMORY_API_KEY": "your-api-key-here",
        "NEXMEMORY_API_URL": "http://localhost:3000/api"
      }
    }
  }
}

1. 启用代理模式：

- 打开命令选项板(Ctrl+Shift+P / Cmd+Shift+P) - 选择 MCP: Add Server - 选择 nexmemory 从列表中

选项2：使用GitHub Copilot和MCP

1. 安装副驾驶MCP搜索扩展：

- 在VS代码扩展中搜索“Copilot MCP搜索” - 安装扩展

1. 通过扩展设置进行配置：

- 添加 nexmemory-mcp 作为新的MCP服务器 - 在扩展设置中配置环境变量

______________________________________________________________________

GitHub Copilot

GitHub Copilot与MCP服务器集成，以增强代码建议。

配置步骤

1. 安装副驾驶MCP搜索扩展：

   # Via VS Code Extensions marketplace
   # Search: "Copilot MCP Search"

1. 配置MCP服务器：

- 打开扩展设置 - 添加 nexmemory-mcp 作为新服务器 - 设置环境变量： - NEXMEMORY_API_KEY - NEXMEMORY_API_URL

1. 重新启动VS代码 以应用更改。

______________________________________________________________________

泽德

Zed是一个内置MCP支持的高性能代码编辑器。

配置步骤

1. 打开设置：

- 按 cmd+, （macOS）或 Ctrl+, （Windows/Linux） - 或者使用命令面板： zed: open settings

1. 添加配置：

{
  "mcpServers": {
    "nexmemory": {
      "command": "npx",
      "args": ["-y", "nexmemory-mcp"],
      "env": {
        "NEXMEMORY_API_KEY": "your-api-key-here",
        "NEXMEMORY_API_URL": "http://localhost:3000/api"
      }
    }
  }
}

1. 重新启动Zed 以应用更改。

______________________________________________________________________

Continue.dev

Continue是VS Code和JetBrains IDE的开源自动驾驶仪。

配置步骤

1. 安装继续扩展：

- VS代码：在扩展中搜索“继续” - JetBrains：从JetBrains市场安装

1. 配置MCP服务器：

- 打开继续设置 - 导航到MCP服务器部分 - 添加配置：

{
  "mcpServers": {
    "nexmemory": {
      "command": "npx",
      "args": ["-y", "nexmemory-mcp"],
      "env": {
        "NEXMEMORY_API_KEY": "your-api-key-here",
        "NEXMEMORY_API_URL": "http://localhost:3000/api"
      }
    }
  }
}

1. 重新启动IDE 以应用更改。

______________________________________________________________________

克莱恩

Cline是一个VS Code扩展，它将AI模型与MCP支持集成在一起。

配置步骤

1. 安装Cline扩展：

- 在VS代码扩展市场中搜索“Cline” - 安装扩展

1. 配置MCP服务器：

- 创建 .cline/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "nexmemory": {
      "command": "npx",
      "args": ["-y", "nexmemory-mcp"],
      "env": {
        "NEXMEMORY_API_KEY": "your-api-key-here",
        "NEXMEMORY_API_URL": "http://localhost:3000/api"
      }
    }
  }
}

1. 重新启动VS代码 以应用更改。

______________________________________________________________________

Roo代码

Roo Code是一个VS Code扩展，用于AI驱动的代码辅助。

配置步骤

1. 安装Roo代码扩展：

- 在VS代码扩展市场中搜索“Roo代码”

1. 配置MCP服务器：

- 打开Roo代码设置 - 添加带有环境变量的MCP服务器配置 - 使用与Cline相同的配置格式

______________________________________________________________________

Zencoder

Zencoder是一个可用于VS Code和JetBrains IDE的编码代理。

配置步骤

1. 安装Zencoder：

- VS代码：在扩展中搜索“Zencoder” - JetBrains：从JetBrains市场安装

1. 配置MCP服务器：

- 打开Zencoder设置 - 导航到MCP配置 - 添加 nexmemory-mcp 有环境变量

______________________________________________________________________

源极图放大器

Sourcegraph Amp支持跨VS Code、Cursor和Windsurf的MCP。

配置步骤

1. 安装源极图放大器：

- 为编辑器安装适当的扩展

1. 配置MCP服务器：

- 打开源代码图设置 - 添加MCP服务器配置 - 为NexMemory API设置环境变量

______________________________________________________________________

🔑 环境变量

在MCP客户端配置中配置这些环境变量：

# Required
NEXMEMORY_API_KEY=your-api-key-here

# Optional (with defaults)
NEXMEMORY_API_URL=http://localhost:3000/api
DEBUG=false

______________________________________________________________________

🛠️ 可用工具

NexMemory MCP服务器提供以下工具：

create_entity

在知识库中创建一个新实体。

参数：

• name （必填）：实体名称
• description （可选）：详细说明
• tags （必填）：标签名称数组
• properties （可选）：自定义键值对

get_entity

通过实体ID检索实体。

参数：

• id （必填）：实体的UUID

update_entity

更新现有实体。

参数：

• id （必填）：实体的UUID
• name （可选）：更新名称
• description （可选）：更新的描述
• tags （可选）：更新标签数组
• properties （可选）：已更新的属性对象

delete_entity

从知识库中删除实体。

参数：

• id （必填）：实体的UUID

list_entities

列出具有可选过滤和分页功能的实体。

参数：

• limit （可选，默认值：50）：最大实体数
• offset （可选，默认值：0）：要跳过的实体数
• tags （可选）：按标签筛选（所有标签必须匹配）

search_entities

对知识库进行语义搜索。

参数：

• query （必填）：自然语言搜索查询
• limit （可选，默认值：10）：最大结果数

______________________________________________________________________

💡 用法示例

示例1：创建实体

{
  "name": "Project Alpha",
  "description": "A revolutionary AI-powered project management system",
  "tags": ["project", "ai", "management"],
  "properties": {
    "status": "active",
    "priority": "high"
  }
}

示例2：搜索实体

{
  "query": "Find all active projects related to AI",
  "limit": 20
}

示例3：更新实体标签

{
  "id": "entity-uuid-here",
  "tags": ["project", "ai", "management", "active"]
}

______________________________________________________________________

🐛 故障排除

常见问题

服务器未启动

• 问题：MCP服务器无法启动
• 解决方案:

- 验证Node.js版本： node --version （要求≥14.0.0） - 检查API密钥设置是否正确 - 验证NexMemory API服务器是否正在运行

连接错误

• 问题：无法连接到NexMemory API
• 解决方案:

- 验证 NEXMEMORY_API_URL 是正确的 - 检查API服务器是否可访问 - 确保API密钥有效

工具未出现

• 问题：工具未显示在客户端中
• 解决方案:

- 重新启动MCP客户端应用程序 - 检查配置文件语法（有效的JSON） - 启用调试模式： DEBUG=true 查看日志

调试模式

启用调试日志以排除问题：

{
  "env": {
    "DEBUG": "true"
  }
}

调试日志将显示在您的终端/控制台中。

______________________________________________________________________

📚 额外资源

• 模型上下文协议文档
• NexMemory文档
• MCP客户端兼容性

______________________________________________________________________

📄 许可证

该项目根据 MIT许可证.

______________________________________________________________________

由以下材料制成❤️ 面向人工智能开发社区