Reflexive Thematic Analysis MCP 服务器

使用说明内容(Markdown格式)

  • 项目简介

    • 这是一个基于 MCP 的服务器实现,旨在为定性分析工作流提供可扩展的后端服务:管理研究数据资源、暴露可执行的分析工具、以及提供可渲染的提示模板与工作流支持。服务器通过 JSON-RPC 与客户端通信,处理资源访问、工具调用和提示获取等请求。
  • 主要功能点

    • 资源与数据管理:对 transcripts、配置、日志等资源进行读写与管理,支持分布式或本地开发环境使用。
    • 工具注册与执行:内置大量工具,用于项目创建、文件读写、分段编码、阶段性分析(Phase 2a/2b/3 等)以及工作流状态查看。
    • 提示与模板渲染:提供方法加载与渲染不同阶段的分析范式、方法论文档和工作流程提示,确保研究者始终以方法为导向进行分析。
    • 会话管理与能力声明:支持会话初始化、进度跟踪、状态更新以及能力清单的暴露,帮助客户端理解可用能力。
    • 多传输协议支持:服务器设计为可在 Stdio、SSE、WebSocket 等传输下工作,兼容 Claude Desktop 等 MCP 客户端。
    • 安全与合规性:对敏感操作有保护机制,明确研究者的解释性权威,日志记录和过程追溯能力。
  • 安装步骤

    1. 安装 Node.js 18+ 环境。
    2. 将仓库克隆到本地或服务器。
    3. 在仓库根目录执行安装与构建:安装依赖、编译为可执行 JS 入口。
    4. 根据需求启动服务器(如使用标准输出传输,运行 dist/server.js)。
    5. 在 Claude Desktop 或等效 MCP 客户端中配置服务器(见下方的配置信息)。
  • 服务器配置 说明:MCP 客户端需要一个 JSON 配置来知道如何启动服务器。配置要包含服务器的名称、启动命令以及启动参数等信息。下列信息基于仓库实现的默认设置进行描述,实际使用时请将路径替换为本地实际路径。 { "server_name": "reflexive_thematic_analysis_mcp", "command": "node", "args": ["/absolute/path/to/reflexive-thematic-analysis-mcp/dist/server.js"] // 说明:command 指定启动服务器的可执行程序,args 为传递的参数列表;绝大多数情况下只需提供 dist/server.js 的绝对路径。 }

  • 基本使用方法

    1. 构建与启动
      • 安装依赖并编译生成服务器执行入口(dist/server.js)。
    2. 客户端连接
      • 在 Claude Desktop 的 MCP 配置中添加服务器条目,指定上面 JSON 配置中的 server_name、command 与 args,以便客户端能够在需要时启动并连接服务器。
    3. 初始化与使用
      • 启动后,客户端应首先通过 MCP 的 init 工具获取使用指引与能力清单;随后按阶段逐步调用相应工具,如 phase2a_code_start、phase2a_code_read_next、phase2a_code_write_segment 等,直至进入 Phase 3(主题生成)等后续阶段。
    4. 跟踪与维护
      • 使用 process 日志、审核笔记、代码日志等工具,确保研究过程可追溯。

服务器信息