🚀 MCP 内存服务器指南

MCP 内存服务器是一款强大的工具，它提供知识图谱管理和错误处理与课程管理等功能，能有效帮助用户实现智能记忆和课程管理，提升工作效率。

🚀 快速开始

环境配置

1. 默认设置：
   • 内存文件路径：memory.json（位于服务器目录）。
2. 自定义配置：
   • 通过环境变量 MEMORY_FILE_PATH 设置自定义路径，例如："MEMORY_FILE_PATH": "/path/to/custom/memory.json"

安装与运行

• Docker 方式：

docker build -t mcp/memory -f src/memory/Dockerfile .

• NPX 方式：

{
    "mcpServers": {
        "memory": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-memory"
            ],
            "env": {
                "MEMORY_FILE_PATH": "/path/to/custom/memory.json"
            }
        }
    }
}

集成到工具

• Claude Desktop：
  • 在 claude_desktop_config.json 中添加 MCP 服务器配置。
  • 示例：

{
    "mcpServers": {
        "memory": {
            "command": "docker",
            "args": ["run", "-i", "-v", "claude-memory:/app/dist", "--rm", "mcp/memory"]
        }
    }
}

✨ 主要特性

知识图谱管理

• 知识图谱：通过构建和操作知识图谱实现智能记忆功能。
• 核心操作：
  • 创建实体：新增节点，支持自定义属性和值。
  • 添加关系：定义两个实体之间的关联，包括类型和方向。
  • 记录观察：存储事实或描述信息作为观察数据。

错误处理与课程管理

• 新建课程：基于错误及其解决方案创建课程条目。
• 相似错误查找：通过错误模式识别匹配的课程。
• 更新课程状态：根据解决方案的有效性调整课程记录。
• 推荐课程：依据上下文提供相关课程建议。

📦 安装指南

环境配置

1. 默认设置：
   • 内存文件路径：memory.json（位于服务器目录）。
2. 自定义配置：
   • 通过环境变量 MEMORY_FILE_PATH 设置自定义路径，例如："MEMORY_FILE_PATH": "/path/to/custom/memory.json"

安装与运行

• Docker 方式：

docker build -t mcp/memory -f src/memory/Dockerfile .

• NPX 方式：

{
    "mcpServers": {
        "memory": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-memory"
            ],
            "env": {
                "MEMORY_FILE_PATH": "/path/to/custom/memory.json"
            }
        }
    }
}

集成到工具

• Claude Desktop：
  • 在 claude_desktop_config.json 中添加 MCP 服务器配置。
  • 示例：

{
    "mcpServers": {
        "memory": {
            "command": "docker",
            "args": ["run", "-i", "-v", "claude-memory:/app/dist", "--rm", "mcp/memory"]
        }
    }
}

💻 使用示例

基础用法

环境配置

{
    "mcpServers": {
        "memory": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-memory"
            ],
            "env": {
                "MEMORY_FILE_PATH": "/path/to/custom/memory.json"
            }
        }
    }
}

高级用法

集成到 Claude Desktop

{
    "mcpServers": {
        "memory": {
            "command": "docker",
            "args": ["run", "-i", "-v", "claude-memory:/app/dist", "--rm", "mcp/memory"]
        }
    }
}

📚 详细文档

新增功能

创建课程

• 输入：lesson 对象，包含错误模式、解决方案步骤和元数据。
• 自动跟踪：记录创建时间和更新状态。
• 验证：确保所有解决方案步骤完整。

寻找相似错误

• 输入：errorPattern 对象，包括错误类型、消息和上下文。
• 输出：按成功率排序的匹配课程列表。
• 包含内容：相关解决方案和验证步骤。

更新课程状态

• 输入：
  • lessonName（字符串）：指定要更新的课程名称。
  • success（布尔值）：指示解决方案是否有效。
• 更新指标：调整成功率和发生频率数据。

获取课程推荐

• 输入：上下文信息（字符串）。
• 输出：按相关性和成功率排序的课程列表。
• 包含内容：完整的解决方案细节和验证步骤。

📄 许可证

此 MCP 服务器遵循 MIT 许可证，允许自由使用、修改和分发软件，具体条款请参考项目仓库中的 LICENSE 文件。

致谢

感谢原项目仓库（https://github.com/modelcontextprotocol/servers）的所有贡献者，特别是 jerome3o - anthropic 为知识图谱功能奠定了基础。在此基础上，我们新增了课程管理和错误处理功能，并完善了文件管理机制。