Thought Logger MCP Server

关键词

本地服务资源管理日志与截图AI 助手集成本地数据源

使用说明（Markdown 格式）

  • 项目简介 Thought Logger 在桌面端以本地服务的形式实现 MCP 服务器，核心职责是向 LPC 客户端提供上下文相关的资源数据、可执行工具及提示模板等能力，并通过 MCP 的 JSON-RPC 进行通信。服务器集成了本地数据源（键盘日志、截图、处理后的日志等）、简易的工具注册（示例：读取并返回指定日期的键日志）以及一个用于渲染/生成 AI 摘要的流程。

  • 主要功能点

    • MCP 服务端能力
      • 处理 MCP 连接与请求，注册工具并响应调用
      • 支持以 HTTP 传输的会话管理（基于会话 ID 的 transport）
      • 提供对本地日志和截图等资源的访问接口
    • 本地数据源
      • 读取按日期组织的键日志、加工后的日志以及截图及其摘要
    • 工具注册
      • 注册一个示例工具 keylogs，用于按日期获取日志内容
    • 安全性与存储
      • 采用本地加密路径管理与权限检查（与密钥存储、 master key 相关的逻辑）

  • 安装步骤

    1. 获取代码
      • 克隆仓库并进入项目目录。
    2. 安装依赖
      • 在仓库根目录执行安装命令安装所需依赖。
    3. 构建与运行
      • 使用现有打包与构建脚本构建应用或直接运行本地服务器（默认监听 8765 端口）以启动 MCP 服务器。
      • 启动后，服务器将暴露 MCP 接入点，客户端可通过配置连接。

  • 服务器配置（MCP 客户端所需的最小连接信息） 说明：以下配置用于 MCP 客户端连接到 Thought Logger 的 MCP 服务器。客户端需要提供 server 名称、启动命令及参数等信息，以便建立与服务器的连接。

    { "serverName": "thought-logger-local", "command": "npx", "args": [ "-y", "mcp-remote", "http://localhost:8765/mcp" ] }

    注释：

    • serverName：服务器在客户端侧的标识名称，用于区分不同的 MCP 服务实例
    • command/args：客户端需要执行的启动命令及其参数，以连接并初始化 MCP 会话
    • 连接地址：http://localhost:8765/mcp（这是 Thought Logger 服务器在本地提供的 MCP 入口）

  • 基本使用方法

    • 启动 MCP 服务端后，确保本地端口 8765 可访问
    • 在客户端（如 Claude Desktop）的 MCP 设置中，使用以上配置启动远程服务
    • 通过 MCP 客户端发送请求，如获取资源、调用工具、获取提示等，Thought Logger 将返回相应的 JSON-RPC 响应
    • 服务器保持会话状态、注册的工具信息及可用资源的可用性

  • 注意事项

    • 该实现以本地文件系统的数据源为基础，涉及日志、截图等的访问需要相应的读取权限
    • MCP 连接需要网络可访问，确保本地防火墙或端口未被阻断

服务器信息

访问项目