Claude Conversation MCP Server (示例)

使用说明（Markdown 格式）

• 项目简介

  • 该仓库提供一个用于 Claude Desktop 集成的 MCP 服务器示例，使用 Model Context Protocol 的服务器框架实现。核心功能通过工具接口对本地会话数据进行访问与查询。

• 主要功能点

  • list_threads：列出所有对话线程及各自包含的会话数。
  • get_thread：获取指定线程中的所有对话内容，合并为一个文本输出，便于展示。
  • search_conversations：在所有对话中按关键词检索，返回匹配的文件与内容摘要。
  • get_conversation：按会话ID获取具体的对话文本。
  • 服务器传输：使用标准的 MCP 服务器传输实现（本示例通过 stdio 传输），支持与客户端的工具调用与文本输出交互。

• 安装步骤

  • 需要具备 Node.js 环境，并在支持 ECMAScript Module 的运行环境中执行。该示例位于仓库的 build/claude/claude-conversation-mcp 目录下，直接运行入口为 index.js（示例脚本使用 ES 模块语法）。
  • 在具备 MCP 依赖的环境中运行该脚本即可启动 MCP 服务。

• 服务器配置（给 MCP 客户端的连接信息，JSON 描述，不作为可直接执行的代码）

  • server name: conversation-history
  • command: node
  • args: ["build/claude/claude-conversation-mcp/index.js"]
  • 说明: 该配置用于 MCP 客户端在启动时通过指定的命令来启动服务器进程，并以 MCP 协议进行通信。推断自仓库中提供的示例脚本路径和入口。

• 基本使用方法

  • 启动后，客户端可以通过 MCP 协议对服务器发起请求，调用 list_threads、get_thread、search_conversations、get_conversation 等工具。
  • 服务器会返回按 MCP 约定的响应结构，文本内容通常包含整理后的会话信息，方便在客户端显示或导出。
  • 注意：此示例的会话数据源为本地的文件系统（threads.json、archive 下的 Markdown 文件等），在实际使用前需将 CONVERSATIONS_DIR 指向包含会话数据的目录并确保权限可读。