配备MCP接口的AI聊天记忆服务器

这是一个AI聊天记忆服务器的示例。它遵循工具CleverChatty支持的接口。

MCP服务器的接口如下：

{
    "tools": [
    {
      "name": "remember",
      "description": "记住一条聊天消息，以便后续提取上下文用于记忆",
      "inputSchema": {
        "properties": {
          "role": { "type": "string" },
          "message": { "type": "string" }
        },
        "required": ["role", "message"]
      }
    },
    {
      "name": "recall",
      "description": "返回之前对话的总结",
      "inputSchema": {
        "properties": {
        },
        "required": []
      }
    }
    ]
}

此工具可以与CleverChatty CLI一起使用，创建具有记忆功能的AI聊天。服务器会记住消息，并在请求时返回之前对话的总结。

如何运行服务器

1. 克隆仓库

git clone git@github.com:Gelembjuk/cleverchatty-memory.git
cd cleverchatty-memory

2. 安装uv（如果尚未安装）

curl -Ls https://astral.sh/uv/install.sh | sh

3. 创建虚拟环境

uv venv

4. 在Linux/macOS上激活虚拟环境（其他平台可能有所不同）

source .venv/bin/activate

5. 安装依赖项

uv sync

6. 运行服务器

fastapi run mcp_server.py --port 8001

这将在8001端口启动带有SSE传输的MCP服务器。您可以通过修改--port参数来更改端口。它可通过URL http://localhost:8001/mcp访问。您也可以使用--host参数更改主机。默认情况下，它只能从本地主机访问。您可以将其更改为--host 0.0.0.0以使其可以从任何IP地址访问。

测试和调试

此工具还包含一个CLI来测试服务器。

python manager.py COMMAND

示例：

python manager.py clear-memory
python manager.py remember "user" "用户发送的一些消息"
python manager.py remember "assistant" "助手的一些响应"
python manager.py patch-memories
python manager.py recall
python manager.py history-dump