spss-mcp 1.1.1__tar.gz

spss_mcp-1.1.1/.env.example

@@ -0,0 +1,28 @@
+# SPSS MCP Server Configuration
+# Copy this file to .env and fill in values as needed
+
+# Path to IBM SPSS Statistics installation directory (or the stats binary).
+# If not set, the server auto-detects via registry (Windows) or /Applications (macOS).
+#
+# Windows:
+#   SPSS_INSTALL_PATH=C:\Program Files\IBM\SPSS Statistics\31
+# macOS:
+#   SPSS_INSTALL_PATH=/Applications/IBM SPSS Statistics 27
+# SPSS_INSTALL_PATH=
+
+# Directory for temporary intermediate files (runner .py and OMS text output)
+# Defaults to %TEMP%\spss-mcp (Windows) or /tmp/spss-mcp (macOS/Linux)
+# SPSS_TEMP_DIR=
+
+# Directory for persistent SPSS outputs (.spv viewer files and executed .sps syntax files)
+# Defaults to <SPSS_TEMP_DIR>/results
+# SPSS_RESULTS_DIR=
+
+# Maximum seconds to wait for an SPSS analysis to complete
+# SPSS_TIMEOUT=120
+
+# Maximum seconds to wait for the persistent SPSS Python engine to start
+# SPSS_STARTUP_TIMEOUT=300
+
+# Set to 1 to force pyreadstat-only mode even if SPSS is installed
+# SPSS_NO_SPSS=0

spss_mcp-1.1.1/.gitignore

@@ -0,0 +1,52 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.so
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+src/*.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+
+# Local config and secrets
+.env
+.env.*
+!.env.example
+
+# Test/cache
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# SPSS runtime outputs
+spss_output_*.txt
+spss_runner_*.py
+spss_viewer_*.spv
+spss_syntax_*.sps
+oms_*.txt
+
+# OS/editor
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+.claude/
+.cursor/
+
+# Audit logs & local tooling
+logs/
+graphify-out/
+
+# Local workspace artifacts
+作业/
+_tmp_*/
+.playwright-cli/

spss_mcp-1.1.1/CHANGELOG.md

@@ -0,0 +1,95 @@
+# Changelog
+
+## [1.1.1] - 2026-10-30
+
+### Changed
+- 项目 / PyPI / CLI 统一改名为 **`spss-mcp`**（Python 包仍为 `spss_mcp`）
+- GitHub 仓库：`kinginsun/spss-mcp`
+- 推荐安装：`uvx --from git+https://github.com/kinginsun/spss-mcp.git spss-mcp`
+
+## [1.1.0] - 2026-10-30
+
+macOS / SPSS 27 fork release（基于上游 1.0.0）。
+
+### Added
+- **macOS 引擎探测与启动**：自动发现 `/Applications/IBM SPSS Statistics *`，定位
+  `Contents/MacOS/stats` 与 `Resources/Python3`，注入 `SPSS_HOME` / `DYLD_*`
+- **JPEG→PNG 出图归一化**：macOS SPSS HTML 内嵌 JPEG 时自动转为 PNG 再做 300 dpi 后处理
+- Mac 探测与 Error SS 误判的单元测试
+
+### Fixed
+- 相对数据路径在 macOS SPSS 上触发 Error #61：统一解析为绝对路径（保留 Windows 盘符路径）
+- ANOVA 表 `Error` 平方和行被误识别为 `Error #nnnn`
+- 纵向样例宽表/长表分数错位；`COMPARE(within_factor)` EMMEANS 语法
+- 持久引擎跨多个 `asyncio.run` 时的 event-loop / Lock 失效
+
+### Changed
+- README / 元数据标明 macOS + Windows；项目 URL 指向本 fork
+
+## [1.0.0] - 2026-08-05
+
+首个正式版。在 0.3.1 的基础上把真机验证范围拉满，并补齐 Agent 侧消费契约。
+
+### Added
+- **论文级出图补齐到 11 类** `spss_chart_*`：直方图 / 正态密度叠加 / 散点 / 分类均值条形 /
+  条形+95%CI / 折线 / 面积 / 分组箱线 / 误差条 / Q-Q / Kaplan-Meier 曲线，
+  统一 PNG / TIFF / EMF 导出（1950×1500 @300dpi），返回文件路径可直接投稿
+- **中介与调节**：`spss_mediation`（Baron & Kenny 三步回归 + Sobel）、
+  `spss_moderation`（中心化交互回归）
+- **统一返回结构** `{markdown, json, files, warnings}`，便于 Agent 编程消费
+- **安全执行层**：危险命令拦截、数据路径白名单、`dry_run` 预检、JSONL 审计日志
+
+### Fixed
+- SPSS 32 移除 `OMS FORMAT=IMAGE` / `IMAGEROOT`，改用 HTML 内嵌 PNG + DOCX 内嵌 EMF 双链路
+- 修复 8 处 SPSS 32 语法兼容问题，37+ 工具（26 个分析方法 + 11 个补充工具）全部真机验收通过
+
+### Changed
+- 版本号从 `0.3.1` 直接跳到 `1.0.0`：能力范围（出图 + 中介调节 + 安全层 + 结构化返回）
+  与真机验收覆盖度已构成完整产品形态，不再以 0.x 迭代
+
+## [0.3.1] - 2026-08-05
+
+### Fixed
+- `spss_chart_boxplot`：GGRAPH `ELEMENT: schema` 在 SPSS 32 对真实数据报
+  `outlier was found inside fences`（个案值恰落在箱须线上），且 DOCX/EMF 导出为
+  0 字节；改为 `EXAMINE /PLOT BOXPLOT` 传统图模板，PNG/TIFF/EMF 均真机验证通过
+  （EMF 18996 字节非零）。修复由实战作业验证触发，见项目规划 5.3。
+
+## [0.3.0] - 2026-08-05
+
+### Added
+- P3 方法验证：26 个分析方法真机验收 + `scripts/method_verification.py`
+- 中介/调节工具：`spss_mediation`（三步回归 + Sobel）、`spss_moderation`（中心化交互）
+- P4 安全层：`security.py`（危险拦截/路径白名单/dry_run/审计 JSONL）
+- 补充工具验收：文件类 6 件 + 状态/语法/结构化 + `spss_genlin`（`scripts/tool_verification.py`）
+- 11 类图 × TIFF 全格式验证
+- 文档：教程、技术报告、生态收录/发布准备
+
+### Fixed
+- `spss_correlations`：`TAILS(2)` → `TWOTAIL`
+- `spss_compute_scale_score`：`MEAN`/`NVALID` 参数逗号分隔
+- `spss_twostep_cluster`：子命令去 `=`、距离默认 LIKELIHOOD、删无效 OUTLIERS/PRINT
+- `spss_discriminant` / `spss_manova`：因子/组值范围；MANOVA 删废弃 METHOD
+- `spss_ordinal_regression`：删无效 `TEST=PARALLEL`
+- `spss_genlinmixed`：subject 名义化、删无效 PRINT
+- `spss_genlin`：`DISTRIBUTION` 并入 MODEL、`PRINT` 无等号
+
+## [0.2.0] - 2026-08-04
+
+### Added
+- P1 出图管线：11 类图 spec + GGRAPH 模板 + `spss_chart_*` 工具
+- OMS 导出双链路：HTML→base64 PNG 提取、DOCX→EMF 提取（SPSS 32 兼容）
+- 图片后处理：Pillow 缩放 1950×1500 + 300 dpi 元数据
+- P2 结果解析：`result_parser.py`（表格 JSON + 16 类统计摘要）
+- `spss_structured_result` 统一返回结构
+- 样例数据与归档：`examples/`（问卷/实验/生存/中介/纵向）
+
+### Fixed
+- GGRAPH 模板：末尾换行、`VARIABLES=x y`、bar 预计算 MEAN/MEANCI、line `color.interior`
+- `poc_chart` 样例数据补 DESCRIPTIVES（INPUT PROGRAM 无输出问题）
+
+## [0.1.0] - 2026-08-04
+
+### Added
+- P0 基座：复用 MIT 引擎/runner/CLI、37 工具基线
+- 项目改名 `spss-mcp`、`configure-codex`、CI（black/isort/pytest）

spss_mcp-1.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SPSS-MCP Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

spss_mcp-1.1.1/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.5
+Name: spss-mcp
+Version: 1.1.1
+Summary: MCP server for IBM SPSS Statistics (macOS + Windows): paper-ready charts, deep result parsing, and safe syntax execution
+Project-URL: Homepage, https://github.com/kinginsun/spss-mcp
+Project-URL: Repository, https://github.com/kinginsun/spss-mcp
+Project-URL: Documentation, https://github.com/kinginsun/spss-mcp/tree/main/docs
+Project-URL: Upstream, https://github.com/flupke91/spss-studio-mcp
+Author: spss-mcp Contributors
+License: MIT
+License-File: LICENSE
+Keywords: chart,data-analysis,macos,mcp,psychology,social-science,spss,statistics
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=2.14.0
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyreadstat>=1.2.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: tabulate>=0.9.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: isort>=5.12.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# spss-mcp (macOS + Windows)
+
+> 让 SPSS 成为 Agent 的「统计引擎 + 制图工厂」：论文级图片、深度结果解析、方法真机验证、安全执行。
+
+**简体中文** ｜ [English](README.en.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)]()
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows-blue.svg)]()
+
+面向 **IBM SPSS Statistics** 的 MCP（Model Context Protocol）服务器，供 Cursor / Claude Code / Codex 等 Agent 调用本机 SPSS。
+
+本仓库基于上游 [`flupke91/spss-studio-mcp`](https://github.com/flupke91/spss-studio-mcp)（MIT），在其能力之上增加了 **macOS / SPSS 27+** 适配与若干兼容性修复，并在 **macOS + IBM SPSS Statistics 27** 真机验证通过。
+
+## 能力概览
+
+- **论文级出图**：11 类 `spss_chart_*`，PNG / TIFF / EMF（1950×1500 @300 dpi）
+- **深度结果解析**：OMS 文本 → Markdown + JSON + 统计摘要
+- **分析方法**：描述 / t / ANOVA / 回归 / 因子 / 信度 / 生存 / 混合模型 / 中介调节等
+- **安全执行**：危险命令拦截、路径白名单、`dry_run`、审计日志
+- **跨平台引擎**：Windows（`stats.exe`）与 macOS（`SPSS Statistics.app` + 捆绑 Python3 XD）
+
+## 本 fork 相对上游的主要改动
+
+| 项 | 说明 |
+|----|------|
+| macOS 探测 | 自动发现 `/Applications/IBM SPSS Statistics *` |
+| XD 启动 | 设置 `SPSS_HOME`、`DYLD_*`，修复捆绑 `libpython` 加载 |
+| 出图 | macOS HTML 内嵌 JPEG → 自动转 PNG，再缩放至 300 dpi |
+| 路径 | 相对路径解析为绝对路径，避免 SPSS Error #61 |
+| 解析 | 避免把 ANOVA 表中的 Error SS 误判为 `Error #` |
+| 样例数据 | 宽表 / 长表纵向数据对齐，便于 RM-ANOVA 与 MIXED |
+
+## 系统要求
+
+- Python 3.10+
+- 本机已授权的 **IBM SPSS Statistics**（已在 **27（macOS）** 验证；上游在 **32（Windows）** 验证）
+- macOS：安装包内需含 `Resources/Python3`（XD API）
+
+## 快速开始（macOS）
+
+```bash
+cd spss-mcp
+pip install -e ".[dev]"
+spss-mcp status   # 应显示 SPSS batch / python: OK
+```
+
+可选：在 `.env` 中指定安装目录：
+
+```bash
+SPSS_INSTALL_PATH=/Applications/IBM SPSS Statistics 27
+```
+
+配置 Cursor（`~/.cursor/mcp.json`）：
+
+```json
+{
+  "mcpServers": {
+    "spss-mcp": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/kinginsun/spss-mcp.git",
+        "spss-mcp",
+        "serve",
+        "--transport",
+        "stdio"
+      ],
+      "env": {
+        "SPSS_INSTALL_PATH": "/Applications/IBM SPSS Statistics 27"
+      }
+    }
+  }
+}
+```
+
+也可用：
+
+```bash
+spss-mcp configure-claude
+spss-mcp configure-codex
+spss-mcp setup-info
+```
+
+## 自然语言示例
+
+```text
+对 examples/data/experiment_study.sav 做独立样本 t 检验（group 分组，posttest）
+用 examples/data/mediation_study.sav 做中介分析：autonomy → satisfaction → performance
+画 examples/data/survey_study.sav 学习投入总分的直方图（带正态密度），PNG 300dpi
+对 examples/data/long_study.sav 做混合模型：score ~ group + time，随机截距 subject=id
+```
+
+纵向数据约定：
+
+- 重复测量 ANOVA（宽表）：`examples/data/longitudinal_study.sav`（`time1`/`time2`/`time3`）
+- MIXED（长表）：`examples/data/long_study.sav`（`id`/`time`/`score`）
+
+## 架构
+
+```text
+MCP 客户端（Cursor / Claude Code / Codex）
+        │  MCP 协议（stdio）
+        ▼
+工具层    50+ 工具：文件/元数据 · 分析方法 · 图表 · 中介/调节
+        ▼
+语法构建   方法模板 + Pydantic 校验 ｜ 安全层
+        ▼
+引擎层    SPSS Python3 XD 持久会话（StartSPSS / Submit）
+        ▼
+输出层    OMS TEXT → Markdown/JSON ｜ HTML → PNG/TIFF ｜ DOCX → EMF
+        ▼
+IBM SPSS Statistics（本机授权；macOS 或 Windows）
+```
+
+## 文档
+
+- [Agent 使用教程](docs/tutorial.md)
+- [技术报告](docs/technical_report.md)
+- [结果解析](docs/result_parsing.md)
+- [安全层](docs/security.md)
+- [更新日志](CHANGELOG.md)
+
+## 致谢与许可证
+
+- 上游：[`flupke91/spss-studio-mcp`](https://github.com/flupke91/spss-studio-mcp)（MIT）
+- 更早上游：`Exekiel179/SPSS-MCP`（MIT）
+- 本仓库同样以 **MIT** 发布

spss_mcp-1.1.1/QUICK_START.md

@@ -0,0 +1,45 @@
+# spss-mcp 快速开始
+
+> 3 步完成部署（已在 macOS + IBM SPSS Statistics 27 真机验证；上游亦在 Windows + SPSS 32 验证）
+
+---
+
+## 第 1 步：安装
+
+```bash
+cd spss-mcp
+pip install -e ".[dev]"
+spss-mcp status   # 应显示 SPSS batch / python: OK
+```
+
+macOS 若未自动发现安装，可设置：
+
+```bash
+export SPSS_INSTALL_PATH="/Applications/IBM SPSS Statistics 27"
+```
+
+## 第 2 步：配置 MCP 客户端
+
+```bash
+spss-mcp configure-codex     # Codex
+spss-mcp configure-claude   # Claude Code
+spss-mcp setup-info         # 打印手动配置片段（含 Cursor）
+```
+
+Cursor：把 `setup-info` 输出写入 `~/.cursor/mcp.json` 的 `mcpServers`，然后 Reload MCP。
+
+## 第 3 步：使用
+
+### 统计分析
+
+- `对 examples/data/survey_study.sav 做描述统计和可靠性分析`
+- `用 examples/data/experiment_study.sav 做独立样本 t 检验（group 分组，posttest）`
+- `对 examples/data/mediation_study.sav 做中介分析：autonomy → satisfaction → performance`
+- `对 examples/data/long_study.sav 做混合模型：score ~ group + time，subject=id`
+
+### 论文级出图
+
+- `画 examples/data/survey_study.sav 学习投入总分的直方图（带正态密度），PNG 300dpi`
+- `用 examples/data/survival_study.sav 画按 treatment 分组的 KM 生存曲线`
+
+图表工具返回 1950×1500 @300dpi 文件路径，可直接用于投稿。

spss_mcp-1.1.1/README.en.md

@@ -0,0 +1,61 @@
+# spss-mcp (macOS + Windows)
+
+> Turn IBM SPSS Statistics into an Agent-ready stats engine and chart factory.
+
+**English** ｜ [简体中文](README.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)]()
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows-blue.svg)]()
+
+An MCP server for **IBM SPSS Statistics**, usable from Cursor / Claude Code / Codex.
+
+This repository is a fork of [`flupke91/spss-studio-mcp`](https://github.com/flupke91/spss-studio-mcp) (MIT) with **macOS / SPSS 27+** engine detection, XD startup fixes, JPEG→PNG chart normalization, path handling, and parser fixes. Verified on **macOS + IBM SPSS Statistics 27**.
+
+## Highlights
+
+- Paper-ready charts (`spss_chart_*`, PNG/TIFF/EMF @300 dpi)
+- Deep OMS result parsing (Markdown + JSON + statistical summaries)
+- Broad method coverage (t-tests, ANOVA, regression, survival, mixed models, mediation/moderation, …)
+- Safety layer (dangerous syntax blocklist, path allowlist, `dry_run`, audit log)
+- Cross-platform engine (Windows `stats.exe` and macOS app-bundle + bundled Python3 XD)
+
+## Quick start (macOS)
+
+```bash
+pip install -e ".[dev]"
+spss-mcp status
+```
+
+Optional:
+
+```bash
+SPSS_INSTALL_PATH=/Applications/IBM SPSS Statistics 27
+```
+
+Cursor `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "spss-mcp": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/kinginsun/spss-mcp.git",
+        "spss-mcp",
+        "serve",
+        "--transport",
+        "stdio"
+      ],
+      "env": {
+        "SPSS_INSTALL_PATH": "/Applications/IBM SPSS Statistics 27"
+      }
+    }
+  }
+}
+```
+
+## License
+
+MIT. Upstream: [`flupke91/spss-studio-mcp`](https://github.com/flupke91/spss-studio-mcp); earlier: `Exekiel179/SPSS-MCP`.

spss_mcp-1.1.1/README.md

@@ -0,0 +1,128 @@
+# spss-mcp (macOS + Windows)
+
+> 让 SPSS 成为 Agent 的「统计引擎 + 制图工厂」：论文级图片、深度结果解析、方法真机验证、安全执行。
+
+**简体中文** ｜ [English](README.en.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)]()
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows-blue.svg)]()
+
+面向 **IBM SPSS Statistics** 的 MCP（Model Context Protocol）服务器，供 Cursor / Claude Code / Codex 等 Agent 调用本机 SPSS。
+
+本仓库基于上游 [`flupke91/spss-studio-mcp`](https://github.com/flupke91/spss-studio-mcp)（MIT），在其能力之上增加了 **macOS / SPSS 27+** 适配与若干兼容性修复，并在 **macOS + IBM SPSS Statistics 27** 真机验证通过。
+
+## 能力概览
+
+- **论文级出图**：11 类 `spss_chart_*`，PNG / TIFF / EMF（1950×1500 @300 dpi）
+- **深度结果解析**：OMS 文本 → Markdown + JSON + 统计摘要
+- **分析方法**：描述 / t / ANOVA / 回归 / 因子 / 信度 / 生存 / 混合模型 / 中介调节等
+- **安全执行**：危险命令拦截、路径白名单、`dry_run`、审计日志
+- **跨平台引擎**：Windows（`stats.exe`）与 macOS（`SPSS Statistics.app` + 捆绑 Python3 XD）
+
+## 本 fork 相对上游的主要改动
+
+| 项 | 说明 |
+|----|------|
+| macOS 探测 | 自动发现 `/Applications/IBM SPSS Statistics *` |
+| XD 启动 | 设置 `SPSS_HOME`、`DYLD_*`，修复捆绑 `libpython` 加载 |
+| 出图 | macOS HTML 内嵌 JPEG → 自动转 PNG，再缩放至 300 dpi |
+| 路径 | 相对路径解析为绝对路径，避免 SPSS Error #61 |
+| 解析 | 避免把 ANOVA 表中的 Error SS 误判为 `Error #` |
+| 样例数据 | 宽表 / 长表纵向数据对齐，便于 RM-ANOVA 与 MIXED |
+
+## 系统要求
+
+- Python 3.10+
+- 本机已授权的 **IBM SPSS Statistics**（已在 **27（macOS）** 验证；上游在 **32（Windows）** 验证）
+- macOS：安装包内需含 `Resources/Python3`（XD API）
+
+## 快速开始（macOS）
+
+```bash
+cd spss-mcp
+pip install -e ".[dev]"
+spss-mcp status   # 应显示 SPSS batch / python: OK
+```
+
+可选：在 `.env` 中指定安装目录：
+
+```bash
+SPSS_INSTALL_PATH=/Applications/IBM SPSS Statistics 27
+```
+
+配置 Cursor（`~/.cursor/mcp.json`）：
+
+```json
+{
+  "mcpServers": {
+    "spss-mcp": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/kinginsun/spss-mcp.git",
+        "spss-mcp",
+        "serve",
+        "--transport",
+        "stdio"
+      ],
+      "env": {
+        "SPSS_INSTALL_PATH": "/Applications/IBM SPSS Statistics 27"
+      }
+    }
+  }
+}
+```
+
+也可用：
+
+```bash
+spss-mcp configure-claude
+spss-mcp configure-codex
+spss-mcp setup-info
+```
+
+## 自然语言示例
+
+```text
+对 examples/data/experiment_study.sav 做独立样本 t 检验（group 分组，posttest）
+用 examples/data/mediation_study.sav 做中介分析：autonomy → satisfaction → performance
+画 examples/data/survey_study.sav 学习投入总分的直方图（带正态密度），PNG 300dpi
+对 examples/data/long_study.sav 做混合模型：score ~ group + time，随机截距 subject=id
+```
+
+纵向数据约定：
+
+- 重复测量 ANOVA（宽表）：`examples/data/longitudinal_study.sav`（`time1`/`time2`/`time3`）
+- MIXED（长表）：`examples/data/long_study.sav`（`id`/`time`/`score`）
+
+## 架构
+
+```text
+MCP 客户端（Cursor / Claude Code / Codex）
+        │  MCP 协议（stdio）
+        ▼
+工具层    50+ 工具：文件/元数据 · 分析方法 · 图表 · 中介/调节
+        ▼
+语法构建   方法模板 + Pydantic 校验 ｜ 安全层
+        ▼
+引擎层    SPSS Python3 XD 持久会话（StartSPSS / Submit）
+        ▼
+输出层    OMS TEXT → Markdown/JSON ｜ HTML → PNG/TIFF ｜ DOCX → EMF
+        ▼
+IBM SPSS Statistics（本机授权；macOS 或 Windows）
+```
+
+## 文档
+
+- [Agent 使用教程](docs/tutorial.md)
+- [技术报告](docs/technical_report.md)
+- [结果解析](docs/result_parsing.md)
+- [安全层](docs/security.md)
+- [更新日志](CHANGELOG.md)
+
+## 致谢与许可证
+
+- 上游：[`flupke91/spss-studio-mcp`](https://github.com/flupke91/spss-studio-mcp)（MIT）
+- 更早上游：`Exekiel179/SPSS-MCP`（MIT）
+- 本仓库同样以 **MIT** 发布

spss_mcp-1.1.1/docs/ecosystem.md

@@ -0,0 +1,81 @@
+# 生态收录与 Release v1.0 准备
+
+> 2026-08-05 ｜ 提交类操作需发布账号，本文件给出可直接使用的条目与说明。
+
+## 1. 项目速览（用于收录/发布）
+
+- **名称**：spss-mcp
+- **一句话**：让 SPSS 成为 Agent 的"统计引擎 + 制图工厂"：论文级图片、深度结果解析、方法真机验证、安全执行。
+- **类别**：data-analysis / statistics / mcp-server
+- **标签**：`spss` `statistics` `mcp` `chart` `result-parsing` `psychology` `social-science`
+- **核心能力（来自技术报告）**：
+  - 11 类论文级图表（PNG/TIFF/EMF，300 dpi）
+  - 16 类分析统计摘要（t/F/r/B/Wald/p/效应量）
+  - 37+ 工具全量真机验收（SPSS 32）
+  - 中介/调节工具（Baron & Kenny + Sobel）
+  - 安全层（拦截/白名单/dry_run/审计）
+
+## 2. LobeHub 收录条目
+
+平台：LobeHub（Lobe Chat MCP/插件市场）。提交方式：通常为 GitHub 仓库提交
+描述文件或 PR。可复制以下条目：
+
+- 仓库：https://github.com/flupke91/spss-studio-mcp
+- LobeHub 插件市场提交入口：https://github.com/lobehub/lobe-chat-plugins
+  （创建 `plugins/<plugin-name>/` 目录，含 `plugin.json` + `README.md`）
+
+```yaml
+# lobehub 条目示例
+name: spss-mcp
+description: >-
+  SPSS Studio MCP：论文级图表导出（11 类图 PNG/TIFF/EMF @300dpi）、深度结果
+  解析（Markdown+JSON+统计摘要）、37+ 方法真机验证、中介/调节分析与安全执行
+  （危险拦截/白名单/dry_run/审计）。适用于心理学/管理学/社科研究。
+category: data-analysis
+tags: [spss, statistics, chart, mcp]
+```
+
+## 3. PulseMCP 收录条目
+
+平台：PulseMCP（MCP 服务器目录）。提交方式：站点表单或 GitHub PR。
+建议填写：
+
+- 提交入口：https://www.pulsemcp.com/submit
+- 仓库：https://github.com/flupke91/spss-studio-mcp
+
+- **Name**: spss-mcp
+- **Short description**: Paper-ready charts, deep result parsing and safe execution for IBM SPSS Statistics via MCP.
+- **Long description**: 引用 `README.md` 的功能清单与 `docs/technical_report.md` 摘要。
+- **Transport**: stdio
+- **Auth**: none（本地 SPSS 授权）
+- **OS**: Windows
+
+## 4. GitHub Release v1.0 草稿
+
+见 `docs/release_notes_v1.0.md`（可直接粘贴到 Release 页面）。
+
+## 5. 提交前检查清单
+
+- [x] 功能与验证：37 工具真机验收（26 方法 + 11 工具）、11 类图 × PNG/EMF/TIFF
+- [x] boxplot 全格式修复（0.3.1）：EMF 非零（约 19 KB），PNG/TIFF 正常
+- [x] 文档：README / QUICK_START / docs（教程、技术报告、出图、解析、验证、安全）
+- [x] 安全：拦截/白名单/dry_run/审计 + `docs/security.md`
+- [x] CI：`.github/workflows/ci.yml`（lint + pytest）
+- [x] 许可证：MIT（含上游说明）
+- [x] 样例图：`examples/charts/*.png` 已用 0.3.1 模板重新归档（11 张，含修复后的 boxplot）
+- [ ] 发布账号操作：创建 GitHub release、提交 LobeHub/PulseMCP 条目
+- [ ] （建议）GitHub 仓库公开前检查：无敏感路径、无本地日志入库（`logs/` 已 gitignore）
+
+## 7. GitHub 发布步骤（发布账号操作）
+
+- [x] 创建公开仓库 `flupke91/spss-studio-mcp` 并推送 `master`（2026-08-05）；
+- [x] 打 tag `v1.0.0` 并创建 Release（正文 = `docs/release_notes_v1.0.md`）；
+- [ ] 提交 LobeHub 条目（lobe-chat-plugins PR）；
+- [ ] 提交 PulseMCP 条目（pulsemcp.com/submit 表单）。
+
+## 6. 对外材料（②的成果，可直接引用）
+
+- 技术报告（论文稿）：`docs/technical_report.md`
+- 使用教程：`docs/tutorial.md`
+- 样例图：`examples/charts/*.png`（可作 README/收录页截图）
+- 验证记录：`docs/method_verification.md`、`docs/tool_verification.json`