星战科技xingzhan.cloud
返回市场
下一代内存-mcp

下一代内存-mcp

作者：nex-gen-tech0 星标更新：2025-11-05
安装使用来源：spider==github.com

项目介绍

NexMemory MCP Server

<div align="center">

NexMemory的知识库和实体管理系统

npm 版本 Node.js 许可证

安装 • 配置 • 使用 • 特性

</div>

📋 目录

🎯 概述

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/apiAPI基础URL
DEBUG❌ 否false启用调试日志（true/false）

🔧 MCP客户端配置

Cursor IDE

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

配置步骤

  1. 定位配置文件：

    • 项目特定：项目根目录下的.cursor/mcp.json
    • 全局：~/.cursor/mcp.json

  2. 添加配置：

{
  "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. 重启Cursor 应用更改。

Claude Desktop

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

配置步骤

  1. 定位配置文件：

    • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows：%APPDATA%\Claude\claude_desktop_config.json`
    • Linux：~/.config/Claude/claude_desktop_config.json

  2. 添加配置：

{
  "mcpServers": {
    "nexmemory": {
      "command": "npx",
      "args": [
        "-y",
        "nexmemory-mcp"
      ],
      "env": {
        "NEXMEMORY_API_KEY": "your-api-key-here",
        "NEXMEMORY_API_URL": "http://localhost:3000/api"
      }
    }
  }
}
  1. 重启Claude Desktop 加载新配置。

Windsurf

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

配置步骤

  1. 定位配置文件：

    • ~/.codeium/windsurf/mcp_config.json

  2. 添加配置：

{
  "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 Code (VS Code)

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

选项1：使用VSCode MCP Bridge扩展

  1. 安装扩展：

    • 在VS Code扩展市场中搜索“VSCode MCP Bridge”
    • 安装由YuTengjing提供的扩展

  2. 配置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: 添加服务器
    • 从列表中选择 nexmemory

选项2：使用GitHub Copilot与MCP

  1. 安装Copilot MCP Search扩展：

    • 在VS Code扩展市场中搜索“Copilot MCP Search”
    • 安装扩展

  2. 通过扩展设置配置：

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

GitHub Copilot

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

配置步骤

  1. 安装Copilot MCP Search扩展：

    # 通过VS Code扩展市场
# 搜索：“Copilot MCP Search”

  2. 配置MCP服务器：

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

  3. 重启VS Code 应用更改。

Zed

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

配置步骤

  1. 打开设置：

    • 按 cmd+,（macOS）或 Ctrl+,（Windows/Linux）
    • 或使用命令面板：zed: 打开设置

  2. 添加配置：

{
  "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. 安装Continue扩展：

    • VS Code：在扩展中搜索“Continue”
    • JetBrains：从JetBrains Marketplace安装

  2. 配置MCP服务器：

    • 打开Continue设置
    • 导航到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

Cline 是一个集成AI模型并支持MCP的VS Code扩展。

配置步骤

  1. 安装Cline扩展：

    • 在VS Code扩展市场中搜索“Cline”
    • 安装扩展

  2. 配置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 Code 应用更改。

Roo Code

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

配置步骤

  1. 安装Roo Code扩展：

    • 在VS Code扩展市场中搜索“Roo Code”

  2. 配置MCP服务器：

    • 打开Roo Code设置
    • 添加MCP服务器配置，并设置环境变量
    • 使用与Cline相同的配置格式

Zencoder

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

配置步骤

  1. 安装Zencoder：

    • VS Code：在扩展中搜索“Zencoder”
    • JetBrains：从JetBrains Marketplace安装

  2. 配置MCP服务器：

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

Sourcegraph Amp

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

配置步骤

  1. 安装Sourcegraph Amp：

    • 安装适合您编辑器的相应扩展

  2. 配置MCP服务器：

    • 打开源graph设置
    • 添加MCP服务器配置
    • 为NexMemory API设置环境变量

🔑 环境变量

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

# 必需
NEXMEMORY_API_KEY=your-api-key-here

# 可选（带有默认值）
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": "项目Alpha",
  "description": "一个革命性的AI驱动的项目管理系统",
  "tags": ["项目", "AI", "管理"],
  "properties": {
    "状态": "活跃",
    "优先级": "高"
  }
}

示例2：搜索实体

{
  "query": "查找所有与AI相关的活跃项目",
  "limit": 20
}

示例3：更新实体标签

{
  "id": "entity-uuid-here",
  "tags": ["项目", "AI", "管理", "活跃"]
}

🐛 故障排除

常见问题

服务器无法启动

  • 问题：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许可证授权。

<div align="center">

为AI开发社区制作 ❤️

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

</div>