Qualitative Researcher MCP Server

Qualitative Researcher MCP Server

site icon
2025.04.01 2
TypeScript定性研究知识图谱研究管理其它
Qualitative Researcher MCP Server 是一个专为定性研究设计的MCP服务器实现,用于管理定性研究知识图谱。它支持研究项目、参与者、访谈、观察、代码、主题和发现的结构化表示,帮助研究人员组织数据、跟踪分析过程、发展主题并从丰富的文本数据中生成见解。
View on GitHub

Overview

基本能力

产品定位

Qualitative Researcher MCP Server 是一个专为定性研究设计的MCP服务器实现,用于管理定性研究知识图谱。

核心功能

  • 持久性研究上下文:维护研究实体和关系的结构化知识图谱
  • 研究会话管理:跟踪研究分析会话,记录进度
  • 主题分析:组织和跟踪数据源中的主题
  • 编码框架:管理层次化编码结构
  • 参与者管理:跟踪参与者数据和贡献
  • 数据源组织:组织访谈、观察和文档
  • 研究问题跟踪:将数据链接到特定研究问题
  • 备忘录写作:记录分析见解
  • 时间序列数据分析:按时间顺序探索数据
  • 代码共现分析:识别不同代码之间的关系
  • 方法论文档:跟踪方法论决策

适用场景

  • 定性研究项目管理
  • 研究数据组织和分析
  • 主题和编码框架开发
  • 研究进度跟踪
  • 方法论文档管理

工具列表

  • startsession:启动新的研究会话,显示当前项目和状态
  • loadcontext:加载特定实体的详细上下文
  • endsession:记录会话结果,包括摘要、备忘录、编码活动等
  • buildcontext:创建新实体、关系或观察
  • deletecontext:删除实体、关系或观察
  • advancedcontext:从知识图谱中检索信息

常见问题解答

  • 数据存储路径可通过环境变量MEMORY_FILE_PATH和SESSIONS_FILE_PATH自定义
  • 支持多种安装方式:npm全局安装、docker容器运行、源码构建

使用教程

使用依赖

  • Node.js环境
  • npm包管理器
  • Docker(可选)

安装教程

从GitHub安装并运行

npx -y github:tejpalvirk/qualitativeresearch

全局安装

npm install -g github:tejpalvirk/qualitativeresearch

Docker安装

docker build -t mcp/qualitativeresearch -f qualitativeresearch/Dockerfile .
docker run --rm -i mcp/qualitativeresearch

从源码构建

git clone https://github.com/tejpalvirk/contextmanager.git
cd contextmanager
npm install
npm run build
cd qualitativeresearch
node qualitativeresearch_index.js

调试方式

  • 检查环境变量设置是否正确
  • 验证数据存储路径是否可写
  • 检查服务是否正常运行
# 检查服务状态
curl http://localhost:3000/status

许可证

该项目遵循 MIT 开源许可条款。