Mem0 MCP For Pm

mem0 MCP项目管理服务器

mem0 MCP Server for Project Management

版本：0.3.3

mem0 MCP服务器连接MCP主机应用程序和mem0云服务，实现结构化项目内存管理和项目相关信息的语义搜索。

______________________________________________________________________

发布说明

v0.3.3

• 修复： get_all_project_memories 和 search_project_memories 现在可以正确使用mem0 v2 API。

- mem0 v2 API替换了 user_id 带有必填项的参数 filters 对象： {"AND": [{"user_id": {"in": ["..."]}}]}. - 经过 user_id 现在直接导致 "Filters are required and cannot be empty" 错误。此版本会自动转换参数。

v0.3.1和v0.3.2

• 修复：通过将消息格式调整为mem0 API，“添加项目内存”工具可以正常工作。
• 在MCP主机配置示例中添加了版本规范。（用于缓存故障排除）

v0.3.0

• 修复：由于mem0云服务改变了数据处理方式，数据处理方式也发生了变化。
• 从基于JavaScript对象的模板更改为基于TOML的模板和指南，这对于mem0云服务的数据提取更有效。
• 添加了日志记录功能（有关详细信息，请查看MCP主机配置部分）。

v0.2.0版本

• 从基于SSE的调用切换到基于stdio的调用，以更好地与MCP主机兼容
• 增加了对基于pipx的安装和执行的支持
• 通过以下方式简化部署 pyproject.toml 脚本入口点

______________________________________________________________________

特性

• 项目内存存储和检索
• 项目信息的语义搜索
• 结构化项目管理数据处理
• 经过全面测试的基于stdio的MCP服务器工具
• 灵活的日志记录：默认情况下为stderr，文件输出通过 --logfile
• 通过pipx兼容接口进行智能CLI调用

______________________________________________________________________

MCP主机配置

运行此MCP服务器时，您 必须通过命令行参数明确指定日志输出模式和（如果启用）绝对日志文件路径.

• --log=off ：禁用所有日志记录（不写入日志）
• --log=on --logfile=/absolute/path/to/logfile.log ：启用日志记录并将日志写入指定的绝对文件路径
• 这两个论点都是 必需的 启用日志记录时。如果缺少路径、路径不是绝对路径或给定的值无效，服务器将退出并出错。

示例：日志记录已禁用

"mem0": {
  "command": "pipx",
  "args": ["run", "mem0-mcp-for-pm", "--log=off"],
  "env": {
    "MEM0_API_KEY": "{apikey}"
  }
}

示例：已启用日志记录（需要绝对日志文件路径）

"mem0": {
  "command": "pipx",
  "args": ["run", "mem0-mcp-for-pm", "--log=on", "--logfile=/workspace/logs/mem0-mcp-server.log"],
  "env": {
    "MEM0_API_KEY": "{apikey}"
  }
}

注： - 启用日志记录时，会写入日志 仅 到指定的绝对文件路径。相对路径或遗漏 --logfile 将导致错误。 - 禁用日志记录时，不会输出任何日志。 - 如果缺少必需的参数或参数无效，服务器将无法启动并打印错误消息。 - MCP服务器进程必须可以访问和写入日志文件。 - 如果您在运行此服务器时遇到问题，可能是因为为pm缓存了旧版本的mem0 mcp。请尝试使用最新版本（set x.y.z 通过以下设置将mem0-mcp for pm设置为最新版本。

______________________________________________________________________

故障排除：pipx缓存问题

通过安装时 pipx，实际过程可能从 缓存环境 在...之下 ~/.cache/pipx/ 而不是 ~/.local/share/pipx/venvs/。在这种情况下，使用重新安装 pipx install --force 更新了venvs目录，但正在运行的进程仍使用旧的缓存代码。

症状

• 您重新安装了 pipx install --force . 但行为没有改变。
• ps aux | grep mem0 显示从运行的进程 ~/.cache/pipx//bin/python.

决心

选项1：在MCP主机配置中指定固定版本（推荐）

明确地固定版本，以便pipx每次都能从PyPI获取正确的版本：

"mem0": {
  "command": "pipx",
  "args": ["run", "mem0-mcp-for-pm==0.3.3", "--log=off"],
  "env": {
    "MEM0_API_KEY": "{apikey}"
  }
}

选项2：手动清除pipx缓存

# Find and remove the stale cache directory
ls ~/.cache/pipx/
rm -rf ~/.cache/pipx//

# Then reinstall
pipx install --force mem0-mcp-for-pm

选项3：终止正在运行的进程

重新安装后，杀死旧进程，以便您的MCP主机（例如VS Code）使用新的二进制文件重新启动它：

kill $(ps aux | grep mem0-mcp-for-pm | grep -v grep | awk '{print $2}')

然后重新加载/重新启动MCP主机应用程序。

"mem0": {
  "command": "pipx",
  "args": ["run", "mem0-mcp-for-pm==x.y.z", "--log=off"],
  "env": {
    "MEM0_API_KEY": "{apikey}"
  }
}

______________________________________________________________________

工具

• add_project_memory
• get_all_project_memories
• search_project_memories
• update_project_memory
• delete_project_memory
• delete_all_project_memories

所有工具均可通过基于stdio的MCP协议获得。

______________________________________________________________________

日志记录

• 默认值：stderr
• 可选： --logfile /path/to/logfile.log

______________________________________________________________________

许可证

请参阅许可证文件。

技术细节

这种分叉的独特之处在于MCP Host和mem0之间的结构化格式，这是TOML等编码格式所期望的。 确保您设置了自定义指令，以便能够更好地处理。

自定义指令

为了使mem0适合项目管理目的，这个分叉对AI有以下说明。

对于mem0

• 检查源代码。

对于MCP主机

要在mem0中注册项目信息，请始终对所有条目使用TOML格式。\ 遵循以下准则，以确保最佳的AI提取、可搜索性和项目管理可用性：

1.使用TOML作为基本格式

• 所有项目内存条目必须以TOML格式的字符串提供。
• 始终至少包含以下顶级字段：

- category （例如，“任务管理”、“项目状态”等） - project （项目名称） - timestamp （ISO 8601格式，例如“2025-04-29T16:00:00+09:00”）

2.推荐模板

下面是常见项目管理用例的TOML模板。\ 根据需要进行调整，但要保持结构和元数据的一致性，以便更好地搜索和提取。

项目状态示例

category = "Project Status"
project = "project-name"
timestamp = "2025-04-29T16:00:00+09:00"
name = "Project Name"
purpose = "Project Purpose"
version = "1.2.0"
phase = "development"
completionLevel = 0.65
milestones = ["Planning", "Development"]
currentFocus = ["Implementing Feature X", "Optimizing Component Y"]

[metadata]
type = "status"
priority = "high"
tags = ["backend", "release"]

任务管理示例

category = "Task Management"
project = "project-name"
timestamp = "2025-04-29T16:00:00+09:00"

[[tasks]]
description = "Implement Feature X"
status = "in-progress"
deadline = "2025-05-15"
assignee = "Team A"
dependencies = ["Component Y"]

[metadata]
type = "task"
priority = "high"
tags = ["frontend", "authentication"]

3.使用run_id进行上下文管理

• 使用 run_id 参数，用于对相关条目进行逻辑分组。
• 推荐格式：\

project:project-name:category:subcategory

• 例子：

  run_id = "project:member-system:feature:authentication"

4.元数据使用

• 始终添加 [metadata] TOML表增强了搜索和过滤功能。
• 例子：

  [metadata]
  type = "task"
  priority = "high"
  tags = ["frontend"]

5.信息生命周期

• 使用 immutable = true 以防止更新。
• 使用 expiration_date = "YYYY-MM-DD" 设置到期日。

6.最佳做法

• 与字段名称和结构保持一致。
• 始终包括 project 和 timestamp.
• 使用清晰、描述性的标签和元数据。
• 如有需要，利用TOML评论获取人工智能提示。

______________________________________________________________________

通过遵循这些基于TOML的指南，您将最大限度地提高mem0项目内存提取和管理的效率。\ 有关更高级的用例，请参阅源代码和服务器端自定义说明。

• 以下仅为示例，请自行寻找最佳之选！！

______________________________________________________________________

mem0有效项目记忆指南（增强版）

本指南概述了使用mem0有效管理项目信息的策略和模板。其目的是通过结构化模板和元数据管理来提高项目数据的可搜索性和可重用性。

信息结构和模板

mem0可以有效地管理以下类型的信息。使用结构化模板可以提高可搜索性和可重用性。请注意，提供的模板是示例，应进行调整以适应特定的项目需求。

1.项目状态管理

模板:

category = "Project Status"
project = "project-name"
timestamp = "2025-04-29T16:00:00+09:00"
name = "Project Name"
purpose = "Project Purpose"
version = "1.2.0"
phase = "development"
completionLevel = 0.65
milestones = ["Planning Phase", "Development Phase"]
currentFocus = ["Implementing Feature X", "Optimizing Component Y"]
risks = ["Concerns about API stability", "Resource shortage"]

2.任务管理

模板:

category = "Task Management"
project = "project-name"
timestamp = "2025-04-29T16:00:00+09:00"

[[tasks]]
description = "Implement Feature X"
status = "in-progress"
deadline = "2025-03-15"
assignee = "Team A"
dependencies = ["Component Y"]

[[tasks]]
description = "Setup Development Environment"
status = "completed"

3.会议纪要

模板:

category = "Meeting Summary"
project = "project-name"
timestamp = "2025-04-29T16:00:00+09:00"
title = "Weekly Progress Meeting"
date = "2025-03-23"
attendees = ["Sato", "Suzuki", "Tanaka"]
topics = ["Progress Report", "Risk Management", "Next Week's Plan"]
decisions = ["Approve additional resource allocation", "Delay release date by one week"]
[[actionItems]]
description = "Procedure for adding resources"
assignee = "Sato"
dueDate = "2025-03-25"
[[actionItems]]
description = "Revise test plan"
assignee = "Suzuki"
dueDate = "2025-03-24"

有效的信息管理技术

1.上下文管理（run_id）

使用mem0 run_id 参数，您可以对相关信息进行逻辑分组。这有助于保持特定的对话流或项目上下文。

推荐格式:

project:project-name:category:subcategory

用法示例:

run_id = "project:member-system:feature:authentication"

2.元数据的有效使用

使用元数据可以提高信息的可搜索性。我们建议使用以下模式：

[metadata]
type = "meeting|task|decision|status|risk"
priority = "high|medium|low"
tags = ["frontend", "backend", "design"]
status = "pending|in-progress|completed"

3.信息生命周期管理

使用 immutable 和 expiration_date 参数，您可以管理信息的生命周期。

用法示例:

immutable = true
expiration_date = "2025-06-30"

实际使用模式

1.Sprint管理示例

category = "Project Status"
project = "member-system"
timestamp = "2025-05-01T10:00:00+09:00"
sprint = "Sprint-2025-05"
duration = "2 weeks"
goals = ["Implement authentication feature", "Improve UI"]
[[tasks]]
description = "Implement login screen"
assignee = "Tanaka"
estimate = "3 days"
[[tasks]]
description = "API integration"
assignee = "Sato"
estimate = "2 days"
[metadata]
type = "status"
tags = ["sprint-planning"]

category = "Project Status"
project = "member-system"
timestamp = "2025-05-08T15:00:00+09:00"
sprint = "Sprint-2025-05"
completionLevel = 0.4
[[status]]
task = "Implement login screen"
progress = 0.7
status = "in-progress"
[[status]]
task = "API integration"
progress = 0.2
status = "in-progress"
blockers = ["Change in API response specification"]
[metadata]
type = "status"
tags = ["sprint-progress"]

2.风险管理示例

category = "Risk Management"
project = "member-system"
timestamp = "2025-05-03T11:00:00+09:00"
[[risks]]
description = "Concerns about external API stability"
impact = "High"
probability = "Medium"
mitigation = "Implement fallback mechanism"
owner = "Development Lead"
status = "open"
[metadata]
type = "risk"
priority = "high"

category = "Risk Management"
project = "member-system"
timestamp = "2025-05-10T16:30:00+09:00"
[[risks]]
description = "Concerns about external API stability"
status = "Resolved"
resolution = "Fallback mechanism implementation completed"
[metadata]
type = "risk"
priority = "medium"

要点

• 标准元数据：始终包含项目名称和时间戳。
• 数据格式：对所有条目使用TOML，并包含 [metadata] 桌子。
• 上下文管理：使用 run_id 分层地保持信息相关性。
• 搜索效率：一致的元数据和结构提高了搜索效率。

4.执行战略

为了实施上述改进，我们建议采取以下步骤：

1. 增强 add_project_memory 方法:

- 更新文档字符串：改进使用示例和参数描述。 - 错误处理：提供更详细的错误信息。 - 响应格式：明确说明使用的参数。

1. 更新自定义说明:

- 丰富模板示例。 - 明确推荐的用法 run_id （引入层次结构）。 - 标准化元数据架构。 - 提供实际使用示例。

这些改进将提高信息管理的可用性和效率，同时保持与现有API的兼容性。

5.总结

拟议的改进在保持与现有mem0 MCP服务器功能兼容性的同时，通过以下方式提供了价值：