Memory MCP

by drdee
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

内存 MCP

使用低级服务器实现和 SQLite 存储来存储和检索记忆的模型上下文协议服务器。

安装

该项目使用uv而不是 pip 进行依赖管理。uv 是一个快速、可靠的 Python 包安装程序和解析器。

使用 uv 安装:

uv pip install memory-mcp

或者直接从源安装:

uv pip install .

对于开发:

uv pip install -e ".[dev]"

如果你没有安装uv,可以按照官方说明进行安装。

用法

运行服务器

memory-mcp

这将启动 MCP 服务器,允许您存储和检索记忆。

可用工具

内存 MCP 提供以下工具:

  • remember :存储带有标题和内容的新记忆
  • get_memory :通过 ID 或标题检索特定记忆
  • list_memories :列出所有存储的记忆
  • update_memory :更新现有记忆
  • delete_memory :删除记忆

使用 MCP Inspect 进行调试

MCP 提供了一个名为mcp inspect的便捷命令行工具,可让您直接调试和与 MCP 服务器交互。

设置

  1. 首先,确保已安装 MCP CLI 工具:
uv pip install mcp[cli]
  1. 在一个终端中启动 Memory MCP 服务器:
memory-mcp
  1. 在另一个终端中,使用mcp inspect连接到正在运行的服务器:
mcp inspect

使用 MCP 检查

连接后,您可以:

列出可用的工具

> tools

这将显示 Memory MCP 服务器提供的所有工具。

调用工具

要调用工具,请使用call命令,后跟工具名称和任何所需的参数:

> call remember title="Meeting Notes" content="Discussed project timeline and milestones."
> call list_memories
> call get_memory memory_id=1
> call update_memory memory_id=1 title="Updated Title" content="Updated content."
> call delete_memory memory_id=1

调试模式

您可以启用调试模式来查看详细的请求和响应信息:

> debug on

这可以帮助您准确了解发送到服务器和从服务器接收的数据。

探索工具模式

要查看特定工具的架构:

> tool remember

这显示了该工具的输入模式、所需参数和描述。

故障排除

如果您遇到问题:

  1. 检查服务器运行终端中的服务器日志是否有任何错误消息。
  2. 在 MCP 检查终端中,启用调试模式并debug on以查看原始请求和响应。
  3. 确保工具参数与预期模式匹配(使用tool命令检查)。
  4. 如果服务器崩溃,请检查服务器终端中是否存在任何未捕获的异常。

发展

要为项目做出贡献,请安装开发依赖项:

uv pip install -e ".[dev]"

管理依赖关系

本项目使用uv.lock文件来锁定依赖项。要更新依赖项,请执行以下操作:

uv pip compile pyproject.toml -o uv.lock

运行测试

python -m pytest

代码格式化

black memory_mcp tests

代码检查

ruff check memory_mcp tests

类型检查

mypy memory_mcp
-
security - not tested
A
license - permissive license
-
quality - not tested

模型上下文协议服务器允许用户使用 SQLite 存储来存储、检索、更新和删除记忆。

  1. Installation
    1. Usage
      1. Running the server
      2. Available Tools
    2. Debugging with MCP Inspect
      1. Setup
      2. Using MCP Inspect
      3. Troubleshooting
    3. Development
      1. Managing Dependencies
      2. Running tests
      3. Code formatting
      4. Linting
      5. Type checking
    ID: 3mv0skjpym