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\31SPSS启动缓慢？
如果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 检验比较男女收入差异克劳德将：
- 读取您的数据文件
- 生成SPSS语法
- 执行分析
- 返回格式化结果
- 保存
.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显示 ✗:
- 创建
.env包含SPSS路径的文件 - 重新启动Claude代码
分析超时
增加超时时间 .env:
SPSS_TIMEOUT=300技能不起作用
- 验证文件是否存在：
%USERPROFILE%\.claude\skills\spss-analyst\SKILL.md
%USERPROFILE%\.claude\skills\spss-mcp-guard\SKILL.md- 重新启动Claude代码
MCP服务器未连接
- 检查设置中的JSON语法
- 验证
spss-mcp命令在终端中工作 - 重新运行
spss-mcp configure-claude - 重新启动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