项目简介
VERITAS是一个专为生物医学研究领域设计的AI框架,旨在通过强制PubMed引用合规性、实时验证科学主张和自动化知识库构建来优化研究工作流。其核心组件之一是对话日志MCP服务器,它以结构化的方式捕获大型语言模型(LLM,如Claude Code)的每次交互历史。这为研究者提供了自动化的会话跟踪和日志生成能力,是VERITAS研究基础设施中不可或缺的上下文服务。
主要功能点
- 自动会话记录: 自动捕获与LLM(如Claude Code)的每次交互,包括用户的提问、AI的回复、以及LLM在过程中调用的外部工具。
- 活动日志: 记录LLM在研究过程中执行的特定活动或重要事件,例如数据分析、文件创建或引用验证等。
- 研究日志生成: 根据历史对话和记录的活动,为指定日期自动生成结构化的研究日志,帮助研究者回顾和总结每日进展。
- 会话统计: 提供关于已记录的会话数量和消息数量的统计信息,帮助用户了解其LLM使用模式。
- 数据持久化: 所有对话、活动和会话元数据都安全地存储在本地SQLite数据库中,确保数据不丢失且易于检索。
安装步骤
为了在您的系统上设置并运行VERITAS 对话日志MCP服务器,请遵循以下步骤:
-
克隆VERITAS仓库: 首先,通过Git将VERITAS仓库克隆到您的主目录下的 '~/VERITAS' 路径:
git clone https://github.com/VMWM/VERITAS.git ~/VERITAS -
安装服务器依赖: 进入 'conversation-logger' 目录,并安装其所需的Node.js依赖:
cd ~/VERITAS/conversation-logger && npm install -
安装自动日志守护进程 (可选但推荐): 在 'conversation-logger' 目录下运行安装脚本,这将设置一个后台守护进程(macOS LaunchAgent),用于自动监控Claude Code配置文件的变化并记录对话,同时定期清理过期的日志。
cd ~/VERITAS/conversation-logger && ./install-watcher.sh注意: 这个守护进程将实现真正的自动化日志记录,而不需要LLM显式调用日志工具。它还会每天凌晨2点自动清理5天前的旧日志。
服务器配置 (供MCP客户端使用)
MCP客户端(例如Claude Desktop应用程序或VS Code的Claude Code扩展)需要知道如何启动并连接到此对话日志MCP服务器。以下是一个标准的JSON配置示例,您可以将其添加到客户端的MCP服务器配置中(例如在 '~/.claude.json' 或 'claude_desktop_config.json' 文件中)。
请务必将 '~/VERITAS/conversation-logger/index.js' 路径替换为您的VERITAS仓库的实际安装路径。
{ "name": "conversation-logger", "command": "node", "args": [ "~/VERITAS/conversation-logger/index.js" ], "description": "VERITAS自定义的会话日志MCP服务器,用于记录LLM对话、活动和工具使用,并生成研究日志。" }
- 'name': 这是服务器的唯一标识符。MCP客户端将使用此名称(例如 'mcp__conversation-logger__*')来调用服务器提供的工具。
- 'command': 指定用于启动MCP服务器的可执行文件或脚本。在这里,它是 'node'。
- 'args': 传递给 'command' 的参数列表。这里指定了 'conversation-logger' MCP服务器的入口JavaScript文件路径。
- 'description': 对服务器功能的简短描述,帮助用户理解其用途。
基本使用方法
一旦对话日志MCP服务器被配置并成功启动,LLM客户端就可以通过调用其暴露的MCP工具来与之交互:
- 记录LLM对话消息: LLM可以调用 'mcp__conversation-logger__log_message' 工具来记录用户输入或自己的响应。例如,当LLM完成一个任务后,可以记录其输出以及在此过程中可能使用的其他工具。
- 记录特定活动: LLM可以调用 'mcp__conversation-logger__log_activity' 工具来标记和记录特定的研究活动或事件,例如“开始数据分析”、“完成引用验证”等。
- 生成研究日志: 研究者或LLM可以请求调用 'mcp__conversation-logger__generate_journal' 工具,为指定日期(例如 '2023-10-26')自动生成一份详细的研究日志,总结当天的会话、使用的工具和完成的活动。
- 获取会话统计: 调用 'mcp__conversation-logger__get_session_stats' 工具可以获取当前会话及历史会话的统计信息。
通过这些功能,VERITAS 对话日志MCP服务器为LLM应用提供了强大的会话记忆和知识管理能力,大大提升了研究工作的可追溯性和组织性。
信息
分类
AI与计算