使用说明

NexMemory MCP服务器

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

安装 • 配置 • 用法 • 特性

📋 目录

概述
特性
安装
配置
环境变量
可用工具
用法示例
故障排除
许可证

🎯 概述

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

✨ 特性

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

📦 安装

快速入门（推荐）

无需安装即可直接运行：

npx nexmemory-mcp

全球安装

npm install -g nexmemory-mcp

然后运行：

nexmemory-mcp

⚙️ 配置

环境变量

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

变量	必填	默认	描述
`NEXMEMORY_API_KEY`	✅ 是	-	您的NexMemory API密钥
`NEXMEMORY_API_URL`	❌ 没有	`http://localhost:3000/api`	API基本URL
`DEBUG`	❌ 没有	`false`	启用调试日志记录(`true`/`false`)

🔧 MCP客户端配置

光标IDE

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

配置步骤

查找配置文件：
- 项目特定: .cursor/mcp.json 在项目根目录中
- 全球: ~/.cursor/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",
        "DEBUG": "false"
      }
    }
  }
}

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

克劳德桌面

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

配置步骤

查找配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- 视窗: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
添加配置：

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

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

帆板运动

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

配置步骤

查找配置文件：
- ~/.codeium/windsurf/mcp_config.json
添加配置：

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

重新启动Windsurf 以应用更改。

Visual Studio代码（VS代码）

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

选项1：使用VSCode MCP桥扩展

安装扩展：
- 在VS代码扩展市场中搜索“VSCode MCP Bridge”
- 由YuTengjing安装扩展
配置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"
      }
    }
  }
}

启用代理模式：
- 打开命令选项板(Ctrl+Shift+P / Cmd+Shift+P)
- 选择 MCP: Add Server
- 选择 nexmemory 从列表中

选项2：使用GitHub Copilot和MCP

安装副驾驶MCP搜索扩展：
- 在VS代码扩展中搜索“Copilot MCP搜索”
- 安装扩展
通过扩展设置进行配置：
- 添加 nexmemory-mcp 作为新的MCP服务器
- 在扩展设置中配置环境变量

GitHub Copilot

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

配置步骤

安装副驾驶MCP搜索扩展：

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

配置MCP服务器：
- 打开扩展设置
- 添加 nexmemory-mcp 作为新服务器
- 设置环境变量：
  - NEXMEMORY_API_KEY
  - NEXMEMORY_API_URL
重新启动VS代码 以应用更改。

泽德

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

配置步骤

打开设置：
- 按 cmd+, （macOS）或 Ctrl+, （Windows/Linux）
- 或者使用命令面板： zed: open settings
添加配置：

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

重新启动Zed 以应用更改。

Continue.dev

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

配置步骤

安装继续扩展：
- VS代码：在扩展中搜索“继续”
- JetBrains：从JetBrains市场安装
配置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"
      }
    }
  }
}

重新启动IDE 以应用更改。

克莱恩

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

配置步骤

安装Cline扩展：
- 在VS代码扩展市场中搜索“Cline”
- 安装扩展
配置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"
      }
    }
  }
}

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

Roo代码

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

配置步骤

安装Roo代码扩展：
- 在VS代码扩展市场中搜索“Roo代码”
配置MCP服务器：
- 打开Roo代码设置
- 添加带有环境变量的MCP服务器配置
- 使用与Cline相同的配置格式

Zencoder

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

配置步骤

安装Zencoder：
- VS代码：在扩展中搜索“Zencoder”
- JetBrains：从JetBrains市场安装
配置MCP服务器：
- 打开Zencoder设置
- 导航到MCP配置
- 添加 nexmemory-mcp 有环境变量

源极图放大器

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

配置步骤

安装源极图放大器：
- 为编辑器安装适当的扩展
配置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"
  }
}

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

📚 额外资源

📄 许可证

该项目根据 MIT许可证.

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

报告问题 • 请求功能 • 贡献

使用说明

NexMemory MCP服务器

📋 目录

🎯 概述

✨ 特性

📦 安装

快速入门（推荐）

全球安装

⚙️ 配置

环境变量

🔧 MCP客户端配置

光标IDE

配置步骤

克劳德桌面

配置步骤

帆板运动

配置步骤

Visual Studio代码（VS代码）

选项1：使用VSCode MCP桥扩展

选项2：使用GitHub Copilot和MCP

GitHub Copilot

配置步骤

泽德

配置步骤

Continue.dev

配置步骤

克莱恩

配置步骤

Roo代码

配置步骤

Zencoder

配置步骤

源极图放大器

配置步骤

🔑 环境变量

🛠️ 可用工具

create_entity

get_entity

update_entity

delete_entity

list_entities

search_entities

💡 用法示例

示例1：创建实体

示例2：搜索实体

示例3：更新实体标签

🐛 故障排除

常见问题

服务器未启动

连接错误

工具未出现

调试模式

📚 额外资源

📄 许可证

相关 MCP

AI持久记忆服务器

Zotero文献库搜索与阅读MCP服务

Qdrant向量搜索MCP服务器

本地LLM模型控制协议

文档搜索服务

Laravel文档聚合工具

`create_entity`

`get_entity`

`update_entity`

`delete_entity`

`list_entities`

`search_entities`