模型上下文协议服务器

memU-mcp是一个将memU云API暴露为MCP工具的服务器,用于保存、检索和管理对话记忆。

  • by De13ruyne
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 De13ruyne/memU-mcp

使用说明

议员mcp

MCP(模型上下文协议)服务器 memU -将memU Cloud API公开为MCP工具。

认证

memU mcp需要一个 memU API 密钥 从 memU平台.

  1. 注册地址: memu.so 并导航到API密钥部分。
  2. 为您的项目创建一个新的API密钥。
  3. 通过以下方式将密钥传递给MCP服务器 MEMU_API_KEY 环境变量或 --memu-api-key CLI参数。

所有工具调用都通过Bearer令牌针对memU Cloud API进行身份验证(api.memu.so).

用法

命令行界面

# Requires MEMU_API_KEY env var
uvx --from git+https://github.com/De13ruyne/memU-mcp memu-mcp


# Explicit arguments
uvx --from git+https://github.com/De13ruyne/memU-mcp memu-mcp \
  --memu-api-key <your-memu-token> \
  --transport stdio

MCP客户端配置

添加到您的MCP客户端配置(OpenClaw、Cursor、Claude Desktop等):

{
  "mcpServers": {
    "memu": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/De13ruyne/memU-mcp", "memu-mcp"],
      "env": {
        "MEMU_API_KEY": "<your-memu-token>"
      }
    }
  }
}

环境变量

变量 描述 必填
MEMU_API_KEY 用于云身份验证的memU API密钥 是
MEMU_API_BASE_URL 自定义 memU API 基础 URL(默认: https://api.memu.so) 没有

工具

工具 说明
memorize 将对话保存到memU云内存(异步,返回task_id)
get_task_status 检查异步记忆任务的状态
retrieve 根据查询搜索相关记忆
list_categories 列出用户的所有内存类别
delete_memory 按ID删除特定内存项
clear_memory 清除用户的所有记忆(不可逆)

发展

# Install dev dependencies
uv sync --group dev

# Run tests
pytest

# Lint
ruff check src tests
mypy src tests

许可证

阿帕奇-2.0