Quantitativeresearch

🚀 定量研究 MCP 服务器使用说明

本 MCP 服务器专为定量研究人员打造，可助力研究人员维护分析连续性、组织统计证据、记录变量关系等，为定量研究提供全面且高效的支持。

🚀 快速开始

本 MCP 服务器专为定量研究人员设计，具备维护分析连续性、组织统计证据等一系列强大功能。下面将为你介绍其安装、配置、使用等方面的详细信息。

✨ 主要特性

• 维护分析连续性：跟踪跨多个研究会话的分析和结果。
• 组织统计证据：将假设与支持性的统计测试和结果相关联。
• 记录变量关系：记录变量之间的相关性、预测性或影响性。
• 跟踪模型开发：文档化统计模型的演变及其性能。
• 支持结果解释：将统计发现与研究问题和理论框架连接起来。
• 确保方法学严谨性：文档化方法论决策和分析方法。
• 准备研究报告：组织统计证据以支持研究发现。
• 跟踪研究进度：跟踪整个研究生命周期中实体状态。
• 优先处理研究任务：识别并专注于高优先级的研究活动。
• 规划研究流程顺序：计划和可视化研究和分析步骤的逻辑顺序。

📦 安装指南

使用 Claude Desktop

在 claude_desktop_config.json 中添加以下内容：

从 GitHub 安装并通过 npx 运行

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

全局安装并直接运行

首先全局安装包：

npm install -g github:tejpalvirk/quantitativeresearch

然后配置 Claude Desktop：

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

使用 Docker

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

从源码构建

# 克隆仓库
git clone https://github.com/tejpalvirk/contextmanager.git
cd contextmanager

# 安装依赖项
npm install

# 构建服务器
npm run build

# 运行服务器
cd quantitativeresearch
node quantitativeresearch_index.js

使用 Docker 构建

docker build -t mcp/quantitativeresearch -f quantitativeresearch/Dockerfile .

💻 使用示例

基础用法

# 显示帮助信息
quantitativeresearch --help

# 显示版本号
quantitativeresearch --version

# 启动服务器
quantitativeresearch start [--port PORT]

# 停止服务器
quantitativeresearch stop

# 重启服务器
quantitativeresearch restart

高级用法

数据存储

# 存储单个数据点
quantitativeresearch store <key> <value>

# 批量存储数据
quantitativeresearch store-batch <key1>=<value1>,<key2>=<value2>...

# 获取数据值
quantitativeresearch get <key>

# 删除数据条目
quantitativeresearch delete <key>

数据分析

# 执行基本统计计算
quantitativeresearch analyze stats [--mean] [--median] [--stddev]

# 生成数据报告
quantitativeresearch report generate [--summary] [--detailed]

数据可视化

# 生成图表
quantitativeresearch visualize plot <key> [--chart-type LINE/BAR/PIE]

# 显示图表
quantitativeresearch visualize show <key>

示例用法

# 存储数据
quantitativeresearch store age=30 name=Alice
quantitativeresearch store-batch height=170,weight=60,BMI=21.5

# 获取并显示分析结果
quantitativeresearch analyze stats --mean
quantitativeresearch report generate --summary

# 可视化数据
quantitativeresearch visualize plot age --chart-type LINE
quantitativeresearch visualize show height

📚 详细文档

环境变量

定量研究 MCP 服务器支持以下环境变量来定制数据存储位置：

示例用法：

# 数据存储在当前位置
MEMORY_FILE_PATH="./quantitative-memory.json" SESSIONS_FILE_PATH="./quantitative-sessions.json" 

# 使用绝对路径指定数据存储位置
MEMORY_FILE_PATH="/path/to/memory.json" SESSIONS_FILE_PATH="/path/to/sessions.json"

# 使用相对路径基于当前工作目录
MEMORY_FILE_PATH="relative/path/to/memory.json" SESSIONS_FILE_PATH="relative/path/to/sessions.json"

错误处理

常见问题

• 端口被占用：如果默认端口（3000）被其他程序占用，服务器无法启动。请确保该端口未被使用，或在启动时指定不同的端口。

  quantitativeresearch start --port 3001
  

• 数据格式错误：在存储数据时，如果键值对格式不正确，会抛出错误。请确保键和值之间用等号分隔，且没有额外空格。

  # 错误示例
  quantitativeresearch store key= value 错误
  
  # 正确示例
  quantitativeresearch store key=value
  

• 未找到数据：在尝试获取或删除不存在的键时，会返回错误信息。

  quantitativeresearch get non_existent_key
  # 输出: 错误：指定的键 'non_existent_key' 不存在
  

退出与调试

安全退出

要安全地关闭服务器，请使用 stop 命令：

quantitativeresearch stop

这将确保所有未完成的操作得以正确处理，并释放所有资源。

调试模式

在遇到问题时，可以启用调试模式以获取更多详细信息：

quantitativeresearch --debug start

这将在控制台输出详细的调试信息，帮助诊断潜在的问题。

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。这意味着你可以自由地使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多详细信息，请参阅项目仓库中的 LICENSE 文件。