🧠 Huppert MCP - NIRS Toolbox Assistant
版本: v1.2 更新: 2026-01-27
NIRS-Toolbox 的 MCP (Model Context Protocol) 服务器，让 AI 助手能直接查阅 fNIRS 数据分析工具文档。
---
⚡ 快速开始
前置要求
- Python 3.10+
- Cursor IDE
- NIRS-Toolbox 完整代码
安装步骤
# 1. 进入项目目录
cd huppert_mcp
# 2. 运行安装脚本
./setup.sh
# 会提示输入 NIRS-Toolbox 路径
# 自动完成：虚拟环境创建、依赖安装、配置生成配置 Cursor
打开 ~/.cursor/mcp.json，添加生成的配置：
{
"mcpServers": {
"huppert": {
"name": "Huppert Lab NIRS Toolbox",
"command": "/完整路径/huppert_mcp/venv/bin/python3",
"args": ["/完整路径/huppert_mcp/nirs_toolbox_mcp.py"],
"env": {
"NIRS_TOOLBOX_PATH": "/完整路径/nirs-toolbox"
}
}
}
}测试
1. Cmd+Q 退出 Cursor
2. 重新打开 Cursor
3. 输入: @huppert 详细介绍 BandPassFilter---
🎯 主要功能
Resources（资源）
category://- 列出所有模块类别module://- 查看特定模块详情demo://- 获取示例代码
Tools（工具）
search_module- 搜索模块get_module_details⭐ - 获取完整模块信息（属性、方法、示例）find_workflow- 查找工作流推荐compare_modules- 对比模块差异
Prompts（提示）
how_to_preprocess- 预处理指南how_to_glm_analysis- GLM分析指南how_to_load_data- 数据加载指南build_pipeline- 构建流水线
---
💻 使用示例
基础查询
@huppert BandPassFilter
@huppert 有哪些滤波模块？详细查询（推荐）
@huppert 详细介绍 AR_IRLS
@huppert 详细介绍 BeerLambertLaw工作流推荐
@huppert 预处理的标准流程是什么？
@huppert 如何进行GLM分析？模块对比
@huppert 对比 BandPassFilter 和 WaveletFilter---
📚 文档
- 快速开始:
START_HERE.md - 用户指南:
docs/USER_GUIDE.md⭐ - 完整教程:
docs/NIRS_MCP_完整指南.md - 故障排查:
docs/MCP问题诊断与解决.md - 所有文档:
docs/DOCS_INDEX.md
---
🐛 故障排查
问题：@huppert 未找到
# 1. 检查配置
cat ~/.cursor/mcp.json
# 2. 检查进程
ps aux | grep nirs_toolbox_mcp
# 3. 重启 Cursor
pkill -f "nirs_toolbox_mcp.py"
# Cmd+Q 退出，重新打开问题：NIRS_TOOLBOX_PATH 未设置
在 ~/.cursor/mcp.json 中添加 env 字段：
"env": {
"NIRS_TOOLBOX_PATH": "/你的路径/nirs-toolbox"
}更多问题查看 docs/MCP问题诊断与解决.md
---
📦 项目结构
huppert_mcp/
├── nirs_toolbox_mcp.py # MCP服务器主程序
├── setup.sh # 自动安装脚本
├── requirements.txt # Python依赖
├── README.md # 项目说明
├── CHANGELOG.md # 版本历史
├── LICENSE # MIT许可证
│
├── docs/ # 文档目录
│ ├── USER_GUIDE.md # 用户指南 ⭐
│ ├── NIRS_MCP_完整指南.md # 完整教程
│ ├── NIRS_MCP_快速入门.md # 快速入门
│ └── MCP问题诊断与解决.md # 故障排查
│
└── tests/ # 测试目录
└── test_nirs_mcp.py---
🔗 相关链接
- NIRS-Toolbox: http://huppertlab.net/nirs-toolbox/
- GitHub: https://github.com/huppertt/nirs-toolbox
- MCP Protocol: https://modelcontextprotocol.io/
- Huppert Lab: http://huppertlab.net/
---
📝 许可证
MIT License - 详见 LICENSE 文件
本项目提供 NIRS-Toolbox 的 MCP 接口，NIRS-Toolbox 本身有其独立的许可证。
---
🙏 致谢
- Theodore J. Huppert 教授 - NIRS-Toolbox 创始人
- Huppert Lab - 工具箱开发团队
- MCP 社区 - 协议开发者
---
让 fNIRS 数据分析更简单！ 🚀
作者: Liam 版本: v1.2 更新: 2026-01-27
