Fillout.io MCP Server

基本能力

产品定位

Fillout.io MCP Server 是一个用于 Fillout.io API 的服务，主要用于表单管理、响应处理和数据分析。

核心功能

1. 表单管理
2. 列出所有表单
3. 获取表单详情
4. 创建新表单
5. 删除表单

6. 更新表单设置

7. 响应处理

8. 提交表单响应
9. 获取表单提交
10. 过滤响应

11. 导出响应

12. 数据分析

13. 响应率
14. 完成时间
15. 提交趋势

适用场景

• 需要收集和处理表单数据的场景
• 需要分析表单响应数据的场景
• 需要自动化表单管理的场景

工具列表

1. list_forms
2. 获取所有可访问的表单
3. 参数：limit（可选）、offset（可选）

4. 返回：表单对象数组

5. get_form

6. 获取详细的表单信息
7. 参数：formId（字符串）

8. 返回：表单详情，包括问题和设置

9. create_form

10. 创建新表单
11. 参数：name（字符串）、description（可选字符串）、questions（数组）

12. 返回：创建的表单对象

13. get_form_responses

14. 获取表单提交
15. 参数：formId（字符串）、filters（可选）、pageSize（可选）、afterDate（可选）、beforeDate（可选）、status（可选）

16. 返回：表单响应数组

17. submit_form_response

18. 提交新响应
19. 参数：formId（字符串）、responses（数组）、calculations（可选）
20. 返回：提交确认

常见问题解答

1. "Invalid API key provided" 或 "Authentication failed"
2. 原因：API 密钥缺失、格式错误或无效

3. 解决方案：验证密钥格式、检查环境变量设置、创建新密钥

4. "Test mode key used with live form"

5. 原因：使用测试密钥 (fo_test_) 与生产表单

6. 解决方案：使用生产密钥或创建测试表单

7. "Rate limit exceeded"

8. 原因：API 请求过多
9. 解决方案：实施请求限制、检查仪表板使用情况、优化请求模式

使用教程

使用依赖

• Node.js 18 或更高版本
• npm 或 yarn
• Docker（可选）

安装教程

Docker 配置

{
  "mcpServers": {
    "fillout": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "FILLOUT_API_KEY",
        "mcp/fillout"
      ],
      "env": {
        "FILLOUT_API_KEY": "your-fillout-api-key"
      }
    }
  }
}

NPX 配置

{
  "mcpServers": {
    "fillout": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fillout"
      ],
      "env": {
        "FILLOUT_API_KEY": "your-fillout-api-key"
      }
    }
  }
}

调试方式

本地开发

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 生产构建
npm run build

Docker 构建

# 构建镜像
docker build -t mcp/fillout .

# 运行容器
docker run -e FILLOUT_API_KEY=your-key mcp/fillout

许可证

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