⚠️ ATTENTION: LLM-GENERATED CODE ⚠️

基本能力

产品定位

LimeSurvey MCP Server 是一个中间件服务，将 LimeSurvey 的远程 API 功能通过 MCP 协议暴露出来，使得开发者可以通过标准化的方式与 LimeSurvey 的调查管理功能进行交互。

核心功能

1. 调查管理：包括列出调查、获取调查属性、激活调查、获取调查语言属性等功能。
2. 问题管理：包括列出问题、列出问题组、获取问题属性等功能。
3. 响应管理：包括获取响应摘要、导出响应、列出响应等功能。
4. 参与者管理：包括添加参与者、列出参与者、获取参与者属性等功能。
5. 统计管理：包括导出统计信息等功能。

适用场景

1. 调查自动化：自动化创建和管理调查，适用于需要频繁进行用户反馈或市场调研的场景。
2. 数据收集与分析：通过 API 收集调查响应并进行统计分析，适用于需要实时数据反馈的场景。
3. 参与者管理：自动化管理调查参与者，适用于大规模调查或长期跟踪调查的场景。

工具列表

1. listSurveys：列出所有用户有权限访问的调查。
2. getSurveyProperties：获取特定调查的详细属性。
3. activateSurvey：激活一个当前未激活的调查。
4. listQuestions：列出特定调查的所有问题。
5. exportResponses：以指定格式导出调查响应。
6. addParticipant：向调查中添加参与者。
7. exportStatistics：以 PDF、Excel 或 HTML 格式导出调查统计信息。

常见问题解答

1. 如何配置 LimeSurvey 远程 API？ 在 .env 文件中设置 LIMESURVEY_API_URL、LIMESURVEY_USERNAME 和 LIMESURVEY_PASSWORD。
2. 如何启动服务器？ 运行 npm start 命令启动服务器。
3. 如何导出调查响应？ 使用 exportResponses 工具，指定调查 ID 和导出格式。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 克隆仓库并安装依赖： bash git clone https://github.com/TonisOrmisson/limesurvey-mcp.git cd limesurvey-mcp npm install

安装教程

1. 克隆仓库： bash git clone https://github.com/TonisOrmisson/limesurvey-mcp.git cd limesurvey-mcp
2. 安装依赖： bash npm install
3. 构建项目： bash npm run build
4. 启动服务器： bash npm start

调试方式

1. 开发模式启动服务器： bash npm run dev
2. 检查 .env 文件配置是否正确。
3. 使用 MCP 客户端连接服务器并测试 API 功能。

许可证

该项目遵循 MIT 开源许可条款。