🚀 质性研究上下文管理器 MCP 服务器
这个 MCP 服务器专为质性研究人员打造，能助力他们高效管理和跟踪研究过程中的各类数据、编码框架以及分析进展，极大提升研究效率与质量。
🚀 快速开始
本 MCP 服务器专为质性研究人员设计，帮助他们高效地管理和跟踪研究过程中的各种数据、编码框架以及分析进展。以下将为你详细介绍该服务器的使用。
✨ 主要特性
- 维护分析连续性：可跟踪跨多个研究会话的分析进度，确保研究分析的连贯性。
- 开发编码框架：能构建、完善并将编码结构应用于质性数据，为研究提供清晰的框架。
- 追踪主题发展：观察主题在分析过程中的出现和演变，把握研究核心动态。
- 管理丰富的数据源：组织和连接访谈记录、田野笔记和文档，实现数据的有序管理。
- 支持理论发展：通过备忘录写作过程记录理论见解，促进研究理论的深化。
- 准备研究发现：将研究结果与支持证据和研究问题相关联，使研究成果更具说服力。
- 增强方法学严谨性：记录方法学决策和分析流程，保证研究方法的科学性。
- 跟踪研究进展：监控整个研究生命周期中的实体状态，掌握研究全局进度。
- 优先处理研究任务：识别并专注于高优先级的研究活动，提高研究效率。
- 规划和可视化分析步骤：计划并可视化研究和分析步骤的逻辑顺序，让研究思路更清晰。
🔧 技术细节
术语定义
以下是质性研究上下文管理器中使用的术语及其定义：
| 属性 | 详情 |
|---|---|
| Code Group（编码组） | 组织和分类相关代码的集合 |
| Code（代码） | 数据分析中的具体概念或主题 |
| Theme（主题） | 研究中发现的核心概念或模式 |
| Memo（备忘录） | 分析过程中记录的理论见解和反思 |
| Session（会话） | 单次分析活动的时间段 |
| Status（状态） | 实体（如编码、主题、活动）在研究过程中的当前状态 |
| Priority（优先级） | 实体的重要性级别，用于帮助研究人员聚焦关键任务 |
核心功能
- 创建和管理代码组
- 可建立新的代码组。
- 能将代码添加到现有代码组中。
- 支持更新或删除代码组及其包含的代码。
- 定义和应用主题
- 识别和记录研究中的核心主题。
- 跟踪主题在分析过程中的演变。
- 将主题与具体的数据片段相关联。
- 维护备忘录
- 记录理论见解、反思和下一步行动。
- 关联备忘录与具体的代码或主题。
- 按优先级或日期管理备忘录。
- 跟踪会话进展
- 记录每次分析活动的详细信息。
- 监控分析进度。
- 保存和恢复之前的分析状态。
- 设置实体状态
- 标记实体（如编码、主题、活动）的状态（例如：进行中、已完成）。
- 更新实体状态以反映研究进展。
- 定义优先级
- 为不同实体分配优先级级别。
- 根据优先级聚焦关键任务或步骤。
- 调整优先级以适应研究需求的变化。
- 规划和可视化分析步骤
- 定义分析活动的逻辑顺序。
- 设置活动之间的依赖关系。
- 视觉化分析流程图以便更好地理解整体结构。
💻 使用示例
基础用法
# 创建新的代码组
python3 qual-manager.py code-group create --name "用户行为"
# 将代码添加到现有代码组中
python3 qual-manager.py code add --code-group "用户行为" --name "互动模式"
# 定义和记录研究中的核心主题
python3 qual-manager.py theme create --name "社交媒体使用" --description "分析用户在社交媒体上的行为模式"
# 创建新的备忘录条目
python3 qual-manager.py memo add --content "需要进一步研究用户隐私问题对互动模式的影响"
# 记录当前分析会话的详细信息
python3 qual-manager.py session start --description "分析社交媒体使用数据"
# 更新代码组的状态
python3 qual-manager.py code-group update-status --name "用户行为" --status "已完成"
# 为特定主题分配高优先级
python3 qual-manager.py theme update-priority --name "社交媒体使用" --priority "高"
📦 安装指南
安装方法
- 通过 npm 安装全局包：
npm install -g github:tejpalv/qualitativeresearch-qual-manager
- 通过 Docker 安装（可选）：
docker pull qualresearch/qm-server
- 配置环境变量： 在终端中设置以下环境变量以自定义服务器行为：
QUAL_MANAGER_DB_URL：数据库连接 URLQUAL_MANAGER_API_KEY：API 访问密钥QUAL_MANAGER_LOG_LEVEL：日志记录级别（例如：INFO、DEBUG）
环境变量说明
以下是质性研究上下文管理器中使用的环境变量及其作用：
| 属性 | 详情 |
|---|---|
QUAL_MANAGER_DB_URL |
数据库连接 URL，用于存储研究数据 |
QUAL_MANAGER_API_KEY |
API 访问密钥，用于保护敏感功能 |
QUAL_MANAGER_LOG_LEVEL |
日志记录级别，可选值包括：DEBUG、INFO、WARN、ERROR、CRITICAL |
示例用法
# 设置数据库连接 URL
export QUAL_MANAGER_DB_URL="mongodb://localhost:27017/qual-research"
# 设置 API 访问密钥
export QUAL_MANAGER_API_KEY="your-secure-api-key-here"
# 设置日志记录级别
export QUAL_MANAGER_LOG_LEVEL="INFO"
📄 许可证
该 MCP 服务器受 MIT 许可证的保护，允许用户自由使用、修改和分发代码。
📞 联系方式
如需获取更多帮助或报告问题，请联系：
- 电子邮件：support@qualresearch.org
- GitHub 仓库：https://github.com/tejpalv/qual-manager
通过质性研究上下文管理器 MCP 服务器，研究人员可以更高效地组织和跟踪他们的分析过程，从而提高研究的整体质量和可重复性。