JinDaGe - memory-mcp-server-go MCP Details

article

README

🚀 内存 MCP 服务器 Go 实现

本项目是内存 MCP 服务器的 Go 语言实现，可用于 AI 助手长期记忆、知识管理等场景，能帮助存储和检索信息，维护实体关系网络。

🚀 快速开始

你可以通过以下步骤快速使用本项目：

安装服务器
启动服务器
按照示例命令进行操作

📦 安装指南

快速安装

使用以下命令进行快速安装：

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

手动构建

如果你想手动构建，可以按照以下步骤操作：

克隆仓库：

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

安装依赖项：

go mod tidy

构建二进制文件：

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 自定义。

错误处理

常见错误

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

升级

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

贡献

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

📄 许可证

本项目采用 MIT 许可证。

🔧 技术细节

依赖项

Go 标准库
其他自定义包

memory-mcp-server-go