MCP Server Chat History
2025.04.29
0
Python聊天历史管理代理式 LLMs交流协作
MCP Server Chat History 是一个基于 Model Context Protocol 的服务，专门为代理式大型语言模型（LLMs）和客户端提供聊天历史的访问和搜索功能。它允许用户列出最近的聊天记录、获取完整的聊天内容、通过关键词搜索聊天记录以及保存消息到聊天中。
View on GitHub
Overview
基本能力
产品定位
MCP Server Chat History 是一个专注于聊天历史管理的服务，旨在为代理式 LLMs 和客户端提供高效、便捷的聊天记录访问和搜索功能。
核心功能
- 列出聊天记录 (
list_chats): 根据用户 ID 列出最近的聊天记录。 - 获取聊天内容 (
get_chat): 通过聊天 ID 获取完整的聊天内容。 - 搜索聊天记录 (
search_chats): 根据关键词搜索用户的聊天记录。 - 保存消息 (
save_message): 将消息追加到指定的聊天中。
适用场景
- 代理式 LLMs: 为代理式 LLMs 提供聊天历史的访问和搜索功能。
- 客户端应用: 客户端可以通过该服务管理用户的聊天记录。
- 聊天记录分析: 通过搜索功能，用户可以快速找到特定的聊天内容。
工具列表
| 工具名称 | 参数 | 描述 |
|---|---|---|
list_chats |
user_id:str, limit:int=10 | 列出用户的最近聊天记录 |
get_chat |
chat_id:str | 获取完整的聊天内容 |
search_chats |
user_id:str, query:str | 根据关键词搜索聊天记录 |
save_message |
chat_id:str, role:str, message:str | 将消息追加到聊天中 |
常见问题解答
- 如何设置聊天日志目录？
通过环境变量
QODO_CHATLOGS_DIR设置聊天日志目录，默认为/chats（Docker 环境）或$HOME/all_qodo_chatlogs（非 Docker 环境）。
使用教程
使用依赖
- Python 3.8 或更高版本
安装教程
使用 pip 安装
pip install mcp-server-chat-history
python -m mcp_server_chat_history
使用 uv 安装
uv pip install mcp-server-chat-history
uv run -m mcp_server_chat_history
使用 Docker 安装
docker build -t mcp/chat-history .
docker run -it --rm -p 3000:3000 -v /absolute/path/to/chats:/chats mcp/chat-history
调试方式
启动服务后，可以通过 MCP 客户端连接并调用提供的工具进行调试。