项目简介

定量研究上下文管理器是一个MCP服务器实现，旨在帮助定量研究人员系统地组织和管理他们的研究项目。它通过知识图谱的方式结构化地存储研究项目、数据集、变量、假设、统计检验、模型和结果等信息，并提供工具进行查询、更新和分析。该服务器旨在提升研究过程的透明度和可重复性，并支持研究人员在多个会话中保持分析的连贯性。

主要功能点

持久化研究上下文： 构建和维护研究实体的知识图谱，跨会话保持研究上下文。
研究会话管理： 跟踪研究分析会话，生成唯一会话ID，记录研究进展。
假设检验跟踪： 记录假设、相关检验及其结论。
数据集管理： 组织和跟踪数据集内的描述性统计信息和变量。
统计分析记录： 记录统计检验、模型及其结果。
变量关系追踪： 跟踪变量之间的相关性、预测关系等。
研究问题关联： 将数据分析与特定的研究问题关联起来。
数据可视化文档化： 记录从数据集和结果创建的可视化。
模型性能监控： 监控统计模型性能指标。
研究发现文档化： 将研究发现与支持性统计证据关联。
研究方法文档化： 跟踪方法论决策和方法。
提供多种工具： 包括会话管理、上下文加载、数据构建、数据删除、高级查询和会话结束等工具，方便用户与知识图谱交互。
领域特定功能： 提供项目概览、数据集分析、假设检验、变量关系、统计结果、可视化画廊、模型性能、研究问题结果和变量分布等领域特定查询功能。

安装步骤

克隆仓库 (如果本地构建):

git clone https://github.com/tejpalvirk/quantitativeresearch.git
cd quantitativeresearch

安装依赖:
```
npm install
```
构建服务器 (如果本地构建):
```
npm run build
```

运行服务器:

cd quantitativeresearch
node quantitativeresearch_index.js

或者使用 'npx':

npx ./quantitativeresearch/quantitativeresearch_index.js

服务器配置

以下是配置 MCP 客户端（如 Claude Desktop）连接到 Quantitative Research Context Manager 的 JSON 配置示例。请根据您的部署方式选择合适的配置。

1. 从 GitHub 安装并使用 npx 运行:

{
  "mcpServers": {
    "quantitativeresearch": {
      "command": "npx",
      "args": [
        "-y",
        "github:tejpalvirk/quantitativeresearch"
      ]
    }
  }
}

2. 全局安装后直接运行:

首先全局安装：

npm install -g github:tejpalvirk/quantitativeresearch

然后配置客户端:

{
  "mcpServers": {
    "quantitativeresearch": {
      "command": "contextmanager-quantitativeresearch"
    }
  }
}

3. 使用 Docker 运行:

{
  "mcpServers": {
    "quantitativeresearch": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/quantitativeresearch"
      ]
    }
  }
}

环境变量配置 (可选):

可以通过环境变量自定义数据存储路径：

'MEMORY_FILE_PATH': 知识图谱数据存储路径，默认为 './quantitativeresearch/memory.json'
'SESSIONS_FILE_PATH': 会话数据存储路径，默认为 './quantitativeresearch/sessions.json'

例如，设置数据存储在当前目录：

MEMORY_FILE_PATH="./quantitative-memory.json" SESSIONS_FILE_PATH="./quantitative-sessions.json" npx github:tejpalvirk/contextmanager-quantitativeresearch

基本使用方法

启动会话: 使用 'startsession' 工具开始一个新的研究会话。这将返回一个唯一的会话ID以及当前研究项目、数据集和模型的概览。
加载上下文: 使用 'loadcontext' 工具加载特定实体（如项目、数据集、变量等）的详细上下文信息。你需要提供实体名称和类型。
构建上下文: 使用 'buildcontext' 工具创建新的实体、关系或观察。例如，可以添加新的研究项目、数据集或变量，或者定义它们之间的关系。
删除上下文: 使用 'deletecontext' 工具删除知识图谱中的实体、关系或观察。
高级上下文查询: 使用 'advancedcontext' 工具进行更复杂的查询操作，例如搜索节点、获取项目概览、数据集分析、变量关系等。
结束会话: 使用 'endsession' 工具记录研究会话的结果。这是一个多阶段过程，允许你逐步记录会话摘要、数据集更新、新的分析结果、可视化、假设检验结果、模型更新和项目状态等信息。

示例 Prompt (结合 Claude Desktop 等 MCP 客户端使用):

开始新会话: 'Let's start a new quantitative research session for my Climate Impact Study project.'
加载项目上下文: 'Load the context for the Climate Impact Study project.'
创建新变量: 'Create a new variable called "Annual Precipitation" that's part of the "Climate Measures" dataset with observations noting it's normally distributed.'
记录会话结果: 'I've just finished analyzing data for my Climate Impact Study. I ran three new regression models...' (配合 'endsession' 工具的参数)

请参考仓库 README.md 中的 "Example Prompts" 和 "Usage" 部分获取更多使用示例和场景。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息