Reflexive Thematic Analysis MCP 服务器
使用说明内容(Markdown格式)
-
项目简介
- 这是一个基于 MCP 的服务器实现,旨在为定性分析工作流提供可扩展的后端服务:管理研究数据资源、暴露可执行的分析工具、以及提供可渲染的提示模板与工作流支持。服务器通过 JSON-RPC 与客户端通信,处理资源访问、工具调用和提示获取等请求。
-
主要功能点
- 资源与数据管理:对 transcripts、配置、日志等资源进行读写与管理,支持分布式或本地开发环境使用。
- 工具注册与执行:内置大量工具,用于项目创建、文件读写、分段编码、阶段性分析(Phase 2a/2b/3 等)以及工作流状态查看。
- 提示与模板渲染:提供方法加载与渲染不同阶段的分析范式、方法论文档和工作流程提示,确保研究者始终以方法为导向进行分析。
- 会话管理与能力声明:支持会话初始化、进度跟踪、状态更新以及能力清单的暴露,帮助客户端理解可用能力。
- 多传输协议支持:服务器设计为可在 Stdio、SSE、WebSocket 等传输下工作,兼容 Claude Desktop 等 MCP 客户端。
- 安全与合规性:对敏感操作有保护机制,明确研究者的解释性权威,日志记录和过程追溯能力。
-
安装步骤
- 安装 Node.js 18+ 环境。
- 将仓库克隆到本地或服务器。
- 在仓库根目录执行安装与构建:安装依赖、编译为可执行 JS 入口。
- 根据需求启动服务器(如使用标准输出传输,运行 dist/server.js)。
- 在 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 的绝对路径。 }
-
基本使用方法
- 构建与启动
- 安装依赖并编译生成服务器执行入口(dist/server.js)。
- 客户端连接
- 在 Claude Desktop 的 MCP 配置中添加服务器条目,指定上面 JSON 配置中的 server_name、command 与 args,以便客户端能够在需要时启动并连接服务器。
- 初始化与使用
- 启动后,客户端应首先通过 MCP 的 init 工具获取使用指引与能力清单;随后按阶段逐步调用相应工具,如 phase2a_code_start、phase2a_code_read_next、phase2a_code_write_segment 等,直至进入 Phase 3(主题生成)等后续阶段。
- 跟踪与维护
- 使用 process 日志、审核笔记、代码日志等工具,确保研究过程可追溯。
- 构建与启动