Fillout.io MCP 服务器使用说明

项目简介

Fillout.io MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它充当了 MCP 客户端（如 Claude）与 Fillout.io API 之间的桥梁。通过此服务器，您可以让 LLM 应用安全地访问和操作您的 Fillout.io 表单数据，实现表单管理、数据收集和分析等功能。

主要功能点

表单管理: 支持列出、获取、创建、删除和更新 Fillout.io 中的表单。
响应处理: 允许提交表单响应，检索表单提交记录，并根据条件过滤和导出响应数据。
数据分析: 提供表单的响应率、完成时间以及提交趋势等分析指标。
工具集成: 内置了一系列工具 (Tools)，例如 'list_forms', 'get_form', 'create_form', 'get_form_responses', 'submit_form_response' 等，这些工具可以通过 MCP 协议被 LLM 客户端调用，从而实现与 Fillout.io 的功能集成。

安装步骤

环境准备: 确保您的机器上已安装 Node.js (版本 18 或更高) 和 npm 或 yarn 包管理器。
获取代码: 从 GitHub 仓库 https://github.com/danielma-tic/fillout-mcp-server 克隆或下载源代码。
安装依赖: 打开命令行终端，进入项目根目录，运行 'npm install' 或 'yarn install' 命令安装项目依赖。
配置 API 密钥: 您需要一个 Fillout.io API 密钥才能连接到 Fillout.io 服务。
- 登录您的 Fillout.io 账户。
- 访问 "Account Settings" -> "API & Webhooks"。
- 创建一个新的 API 密钥并复制它。
- 将此 API 密钥设置为环境变量 'FILLOUT_API_KEY'。例如，在 Docker 运行或 NPX 配置中设置，或者在本地环境中设置系统环境变量。

服务器配置

为了将 Fillout.io MCP 服务器连接到 MCP 客户端 (例如 Claude Desktop)，您需要在客户端的 MCP 服务器配置中添加以下 JSON 配置信息。请务必将 '"your-fillout-api-key"' 替换为您的实际 Fillout.io API 密钥。

推荐配置 (Docker): 如果您使用 Docker 运行服务器，可以使用以下配置。这需要在您的机器上安装 Docker。

{
  "mcpServers": {
    "fillout": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "FILLOUT_API_KEY",
        "mcp/fillout"
      ],
      "env": {
        "FILLOUT_API_KEY": "your-fillout-api-key" // 请替换为您的 Fillout.io API 密钥
      }
    }
  }
}

NPX 配置 (开发环境): 如果您希望在本地开发环境中快速启动服务器，可以使用 NPX 配置。这需要在您的机器上安装 Node.js 和 npm。

{
  "mcpServers": {
    "fillout": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fillout" // 请注意，实际包名可能需要根据发布情况调整
      ],
      "env": {
        "FILLOUT_API_KEY": "your-fillout-api-key" // 请替换为您的 Fillout.io API 密钥
      }
    }
  }
}

本地开发运行配置: 如果您希望直接通过 npm 运行开发服务器，可以使用以下配置。

{
  "mcpServers": {
    "fillout": {
      "command": "npm",
      "args": [
        "run",
        "dev"
      ],
      "env": {
        "FILLOUT_API_KEY": "your-fillout-api-key" // 请替换为您的 Fillout.io API 密钥
      }
    }
  }
}

基本使用方法

完成配置后，您的 MCP 客户端应该能够检测到 Fillout.io MCP 服务器。您可以使用客户端提供的界面或命令来调用服务器提供的工具，例如：

使用 'list_forms' 工具列出您 Fillout.io 账户中的所有表单。
使用 'get_form' 工具获取指定表单的详细信息。
使用 'get_form_responses' 工具查询表单的提交数据。
使用 'create_form' 工具创建新的 Fillout.io 表单。
使用 'submit_form_response' 工具提交表单响应数据。

具体的工具名称、参数和使用方法，请参考仓库的 'README.md' 文件中 "Tools" 章节的详细说明。

关键词