AI导哈

SPSS统计分析服务

SPSS-MCP是一款为AI助手提供直接访问IBM SPSS Statistics进行统计分析的服务，能够将自然语言描述转换为SPSS语法并执行分析。

  • by Exekiel179
  • Python
  • 本地部署
  • 26 星标
  • 更新于
在 GitHub 查看 Exekiel179/SPSS-MCP

使用说明

SPSS-MCP

A. 模型上下文协议（MCP） 允许AI助手直接访问的服务器 IBM SPSS 统计软件 用于统计分析。

用简单的语言描述你的分析——SPSS-MCP将其转换为SPSS语法，在真正的SPSS引擎上运行，并返回Markdown格式的结果。

🚀 快速开始： 查看 快速启动.md 或直接运行 install.bat 一键安装

呈现页面

配套网页主题：Claude Code 与 SPSS-MCP：从概念到一键配置

适合培训、汇报和课堂演示，内容覆盖：

  • 什么是 Claude Code，以及它和网页对话式协作的区别
  • 什么是 MCP 协议
  • Claude Code 的安装与配置
  • GLM key 获取
  • SPSS-MCP 的安装、配置与一键接入
  • 简单统计分析示例与现场演示路径

联系

  • 公众号：人类变量
  • 微信：Exekiel179

需求

  • Windows 10/11
  • Python 3.10+
  • IBM SPSS统计软件（20-31版）
  • 支持MCP的Claude代码

快速安装

一键（推荐）

git clone https://github.com/Exekiel179/SPSS-MCP.git
cd SPSS-MCP
install.bat

然后重新启动Claude Code。完成！

手动安装

# 1. Install
pip install -e .

# 2. Auto-configure Claude Code
spss-mcp configure-claude

# 3. Restart Claude Code

配置

基本设置

推荐：让SPSS-MCP为您自动配置Claude Code：

spss-mcp configure-claude

此命令：

  • 检测您的SPSS安装
  • 合并 mcpServers.spss 进入Claude Code的用户配置(~/.claude.json)
  • 在更新现有设置之前创建带时间戳的备份

如果您更喜欢手动设置，请将其添加到Claude Code设置中(Ctrl+, → 搜索 mcpServers):

{
  "mcpServers": {
    "spss": {
      "command": "spss-mcp",
      "args": ["serve", "--transport", "stdio"]
    }
  }
}

SPSS路径（如果未自动检测）

创建 .env 文件：

SPSS_INSTALL_PATH=C:\Program Files\IBM\SPSS Statistics\31

SPSS启动缓慢？

如果SPSS本身在您的机器上启动缓慢，请增加引擎启动超时：

SPSS_STARTUP_TIMEOUT=300

这与 SPSS_TIMEOUT，它控制引擎已经运行后每个分析作业的超时。

可选：安装技能

技能使分析更加可靠，并自动保存结果：

set SKILLS_DIR=%USERPROFILE%\.claude\skills
xcopy /E /I skills\spss-analyst "%SKILLS_DIR%\spss-analyst"
xcopy /E /I skills\spss-mcp-guard "%SKILLS_DIR%\spss-mcp-guard"

安装后重新启动Claude Code。

用法

用自然语言描述你的分析：

请对 data.sav 进行描述性统计

分析 age 和 income 的相关性

用 t 检验比较男女收入差异

克劳德将：

  1. 读取您的数据文件
  2. 生成SPSS语法
  3. 执行分析
  4. 返回格式化结果
  5. 保存 .spv 和 .sps 文件

输出文件

每次分析都会产生：

文件 描述
.spv SPSS查看器文件（在SPSS中打开以查看完整图表）
.sps SPSS语法文件（运行的确切命令）

默认位置： %TEMP%\spss-mcp\results\

安装技能后： spss_result/ 在您的工作目录中

可用工具

文件和数据（9个工具）

  • spss_check_status -检查服务器功能
  • spss_list_files -列出.sav文件
  • spss_list_variables -列出带有标签的变量
  • spss_read_metadata -读取变量类型和标签
  • spss_read_data -预览数据行
  • spss_file_summary -获取文件统计信息
  • spss_import_csv -将CSV转换为.sav

基础统计（9个工具）

  • spss_frequencies -频率表
  • spss_descriptives -平均值、标准差、最小值、最大值
  • spss_crosstabs -带卡方的应急表
  • spss_t_test -独立/配对/单样本t检验
  • spss_anova -单因素方差分析与事后分析
  • spss_correlations -皮尔森/斯皮尔曼相关性
  • spss_regression -线性回归
  • spss_normality_outliers -正态性检验
  • spss_nonparametric_tests -曼恩·惠特尼、威尔科克森、克鲁斯卡尔·沃利斯

高级分析（18种工具）

  • 逻辑回归（二元/多项式/序数）
  • 广义线性模型（GLM、GENLIN、GENLINMIXED）
  • 混合型号（Mixed）
  • 生存分析（Cox回归，Kaplan-Meier）
  • 多元分析（因子分析、多元方差分析、判别分析）
  • 聚类（分层，两步）
  • 可靠性（Cronbach'sα）
  • 还有更多。..

总计：36个工具 跨越8个类别

故障排除

未检测到SPSS

跑 spss-mcp status.如果SPSS显示 ✗:

  1. 创建 .env 包含SPSS路径的文件
  2. 重新启动Claude代码

分析超时

增加超时时间 .env:

SPSS_TIMEOUT=300

技能不起作用

  1. 验证文件是否存在：
    %USERPROFILE%\.claude\skills\spss-analyst\SKILL.md
%USERPROFILE%\.claude\skills\spss-mcp-guard\SKILL.md
  2. 重新启动Claude代码

MCP服务器未连接

  1. 检查设置中的JSON语法
  2. 验证 spss-mcp 命令在终端中工作
  3. 重新运行 spss-mcp configure-claude
  4. 重新启动Claude代码

平台支持

平台 文件工具 分析工具
Windows 10/11 ✓ ✓ （需要SPSS）
macOS ✓ ✗
Linux ✓ ✗

分析工具需要SPSS XD API（仅限Windows）。

发展

# Compile check
python -m compileall src/spss_mcp

# Run tests
pytest

# Format code
black src/ tests/
isort src/ tests/

# CLI commands
spss-mcp status       # Check environment
spss-mcp setup-info   # Generate config
spss-mcp configure-claude  # Auto-update Claude Code settings

许可证

麻省理工学院——见 许可证

链接

  • 快速开始: 快速启动.md
  • 问题: https://github.com/Exekiel179/SPSS-MCP/issues
  • MCP协议: https://modelcontextprotocol.io

相关 MCP