内存 MCP 服务器 Go 实现

安装

快速安装

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 标准库
• 其他自定义包