🚀 内存 MCP 服务器 Go 实现

本项目是内存 MCP 服务器的 Go 语言实现，可用于 AI 助手长期记忆、知识管理等场景，能帮助组织信息、追踪关系和保留上下文。

🚀 快速开始

你可以按照以下步骤快速安装和使用本项目。

📦 安装指南

快速安装

使用以下命令快速安装最新版本：

go install github.com/mark3labs/memory-mcp-server-go@latest

手动构建

若你想手动构建项目，可按以下步骤操作：

1. 克隆仓库：

git clone https://github.com/mark3labs/memory-mcp-server-go.git
cd memory-mcp-server-go

2. 安装依赖项：

go mod tidy

3. 构建二进制文件：

go build -o bin/memory-mcp-server-go .

💻 使用示例

启动服务器

使用以下命令启动服务器，并指定端口：

memory-mcp-server-go --port 5001

配置

默认配置

• 监听地址：localhost
• 端口：5001
• 数据文件路径：当前目录下的 memory.json

示例命令

基础用法

创建实体：

memory-mcp-server-go --port 5001 create_entities '{"name":"John Smith","entityType":"Person","observations":["Software engineer","Lives in San Francisco","Enjoys hiking"]}'

高级用法

建立关系：

memory-mcp-server-go --port 5001 create_relations '{"from":"John Smith","to":"Acme Corp","relationType":"works at"}'

📚 详细文档

知识图谱结构

实体

知识图谱中的实体结构示例如下：

{
  "entities": [
    {
      "name": "John Smith",
      "entityType": "Person",
      "observations": ["Software engineer", "Lives in San Francisco", "Enjoys hiking"]
    }
  ]
}

关系

知识图谱中的关系结构示例如下：

{
  "relations": [
    {
      "from": "John Smith",
      "to": "Acme Corp",
      "relationType": "works at"
    }
  ]
}

使用场景

• AI 助手的长期记忆：使 AI 助手能够记住用户的偏好、过去的互动和重要事实。
• 知识管理：组织关于人、地点、事件和概念的信息。
• 关系追踪：维护实体之间的关系网络。
• 上下文持久性：保留重要的上下文跨多个会话。

配置示例

配置用于 Claude.app

在你的 Claude 设置中添加以下内容：

"mcpServers": {
  "memory": {
    "command": "memory-mcp-server-go",
    "env": {
      "MEMORY_FILE_PATH": "/Path/Of/Your/memory.json"
    }
  }
}

配置用于 Cursor

在你的 Cursor 设置的 mcp.json 中添加以下内容：

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp-server-go",
      "env": {
        "MEMORY_FILE_PATH": "/Path/Of/Your/memory.json"
      }
    }
  }
}

系统提示示例

你可以使用以下系统提示来帮助 Claude 更好地利用 memory-mcp-server：

你有一个知识图谱记忆系统，可以存储和检索对话中的信息。请使用这个系统来记住重要的上下文和关联。

内存文件路径

• 默认路径：./memory.json
• 可通过环境变量 MEMORY_FILE_PATH 自定义。

错误处理

常见错误

1. 文件不存在：
   • 检查文件路径是否正确。
   • 初始化一个新文件：touch memory.json
2. 端口被占用：
   • 捕获错误信息：地址已被使用
   • 尝试其他端口：--port 5002

升级

使用以下命令升级到最新版本：

go install github.com/mark3labs/memory-mcp-server-go@latest

贡献

• 提交问题到 GitHub Issues。
• 提交功能请求或修复。

📄 许可证

本项目采用 MIT 许可证。

🔧 技术细节

依赖项

• Go 标准库
• 其他自定义包