项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1027
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 运行环境(README 要求用 node 运行 build/index.js)
- pnpm 包管理器(README 使用 pnpm install / build)
- 已初始化并可写入的聊天数据库 chat.db(需先按 chatbot/README.md 配置)
- Claude Desktop 客户端(用于挂载该 MCP Server)
安装与启动步骤
-
1准备聊天数据库
进入 chatbot 目录,按其中的 README 初始化聊天数据库,并启动 chatbot 保存聊天消息,否则无数据可查。
cd chatbot -
2配置环境变量
在项目根目录创建 .env 文件,写入聊天数据库路径,README 示例值为 CHAT_DB_PATH=path-to/chatbot/data/chat.db。
CHAT_DB_PATH=path-to/chatbot/data/chat.db -
3安装依赖
在项目根目录执行,安装 TypeScript 项目依赖。
pnpm install -
4构建服务器
编译生成 build/index.js,供 Claude Desktop 作为 MCP Server 启动入口。
pnpm build -
5配置 Claude Desktop
编辑 Claude Desktop 配置文件,把命令、入口脚本路径和数据库环境变量填成真实路径,保存后重启客户端。
{ "mcpServers": { "mcp-server-chatsum": { "command": "path-to/bin/node", "args": ["path-to/mcp-server-chatsum/build/index.js"], "env": { "CHAT_DB_PATH": "path-to/mcp-server-chatsum/chatbot/data/chat.db" } } } }
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
CHAT_DB_PATH | 是 | 聊天数据库文件的路径,服务器据此读取聊天记录 | path-to/mcp-server-chatsum/chatbot/data/chat.db |
mcpServers.mcp-server-chatsum.command | 是 | 启动 MCP Server 的 node 可执行文件路径 | path-to/bin/node |
mcpServers.mcp-server-chatsum.args | 是 | 构建产物入口脚本路径 | path-to/mcp-server-chatsum/build/index.js |
mcpServers.mcp-server-chatsum.env.CHAT_D | 是 | 传给服务器的数据库路径环境变量 | path-to/mcp-server-chatsum/chatbot/data/chat.db |
如何确认成功
重启 Claude Desktop 后,能看到并调用 query_chat_messages 工具查询、总结聊天消息,即接入成功。
常见问题
Q:Claude Desktop 配置文件放在哪里?
A:MacOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json,Windows 为 %APPDATA%/Claude/claude_desktop_config.json。
Q:为什么查询不到聊天数据?
A:README 要求先进入 chatbot 目录按其 README 搭建聊天数据库,并启动 chatbot 保存聊天消息,之后才有数据可查。
Q:怎么调试这个 MCP Server?
A:MCP 通过 stdio 通信、调试较困难,README 推荐使用 MCP Inspector(其仓库中提供了安装方式,README 未给出具体命令)。
Q:开发时每次改动都要重新构建吗?
A:可以用 pnpm watch 启动自动重建模式,修改源码后自动编译。
注意事项
- README 中的 path-to/ 是占位符,必须替换为你本机的真实绝对路径。
- 必须先准备好 chat.db 聊天数据库,否则服务器没有可查询的数据。
- 项目仅为 Claude Desktop 等 MCP 客户端提供 query_chat_messages 工具,本身不负责采集聊天消息。
核心亮点
- 提供标准 MCP 接口,无缝集成到 Claude 等 AI 工具,降低使用门槛
- 支持灵活的查询条件(关键词、时间、参与者),精准定位所需消息
- 自动生成对话摘要,节省人工翻阅历史记录的时间
不足之处
- 仅支持 MCP 协议,不兼容非 MCP 的 AI 框架
- 文档/社区待观察
适用场景
- 个人用户让 AI 总结过去一周的微信聊天要点
- 团队集成到内部 AI 助手,快速检索项目讨论记录
- 开发者构建聊天分析工具,利用 MCP 标准接入多种聊天数据源
替代项目
mcp-server-chatgpt-retrieval、chat-summary-mcp、memory-server
同类项目推荐
llm-space
开源
可视化调试AI Agent,失败回放+性能评估,一站式搞定。
A desktop app to prototype agent ideas, inspect every harness step, replay failures,···
Interactive-LLM-Powered-NPCs
开源
让游戏NPC拥有大模型大脑,实现动态对话与自主行动
Interactive LLM Powered NPCs, is an open-source project that completely transforms y···
ai-pdf-chatbot-langchain
开源
合同报告丢进去,想问哪页问哪页,秒出答案
AI PDF chatbot agent built with LangChain & LangGraph
leapmux
开源
一个入口,统一调度所有 AI 编程助手,告别来回切换。
AI Coding Agent Multiplexer
openakita
开源
用技能+智能体拼装你自己的 AI 助手
An open-source AI assistant framework with skills and agent architecture
lelu
开源
给AI智能体装上授权闸门,关键操作先过审再执行
Open source authorization engine for AI agents. Confidence-aware gating · Human-in-···
wechat-bot
开源
一个机器人接管你的所有聊天软件,自动回复+社群分析
Multi-platform IM AI Agent for Telegram, WhatsApp, Lark, and WeChat. Connects ChatGP···
Magic-Insight
开源
一个对话框搞定文档、数据库、图像,快速获取数据见解
One-stop data intelligence agent, providing insights from all mainstream data format···
ZZZ-HiveMind-core
开源
把多个语音助手连成一张网,协同干活
Join the OVOS collective, utils for OpenVoiceOS mesh networking
