项目简介

VERITAS是一个专为生物医学研究领域设计的AI框架,旨在通过强制PubMed引用合规性、实时验证科学主张和自动化知识库构建来优化研究工作流。其核心组件之一是对话日志MCP服务器,它以结构化的方式捕获大型语言模型(LLM,如Claude Code)的每次交互历史。这为研究者提供了自动化的会话跟踪和日志生成能力,是VERITAS研究基础设施中不可或缺的上下文服务。

主要功能点

  • 自动会话记录: 自动捕获与LLM(如Claude Code)的每次交互,包括用户的提问、AI的回复、以及LLM在过程中调用的外部工具。
  • 活动日志: 记录LLM在研究过程中执行的特定活动或重要事件,例如数据分析、文件创建或引用验证等。
  • 研究日志生成: 根据历史对话和记录的活动,为指定日期自动生成结构化的研究日志,帮助研究者回顾和总结每日进展。
  • 会话统计: 提供关于已记录的会话数量和消息数量的统计信息,帮助用户了解其LLM使用模式。
  • 数据持久化: 所有对话、活动和会话元数据都安全地存储在本地SQLite数据库中,确保数据不丢失且易于检索。

安装步骤

为了在您的系统上设置并运行VERITAS 对话日志MCP服务器,请遵循以下步骤:

  1. 克隆VERITAS仓库: 首先,通过Git将VERITAS仓库克隆到您的主目录下的 '~/VERITAS' 路径:

    git clone https://github.com/VMWM/VERITAS.git ~/VERITAS
  2. 安装服务器依赖: 进入 'conversation-logger' 目录,并安装其所需的Node.js依赖:

    cd ~/VERITAS/conversation-logger && npm install
  3. 安装自动日志守护进程 (可选但推荐): 在 '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与计算