Danielma Tic Fillout MCP Server

🚀 Fillout.io MCP 服務器

Fillout.io MCP 服務器基於 Fillout.io API 構建，可實現表單管理、響應處理和分析等功能，為用戶提供便捷的表單操作體驗。

🚀 快速開始

使用本服務器前，需先完成令牌設置，獲取並配置 Fillout.io API 密鑰。

📦 安裝指南

本地開發配置

# 安裝依賴
npm install

# 運行開發模式
npm run dev

# 構建生產版本
npm run build

Docker 配置

# 構建鏡像
docker build -t mcp/fillout .

# 運行容器
docker run -e FILLOUT_API_KEY=你的密鑰 mcp/fillout

🔑 令牌設置

1. 獲取 Fillout.io API 密鑰：
   • 登錄到你的 Fillout.io 賬戶。
   • 前往賬戶設置 → API 和 Webhook。
   • 點擊“創建新 API 密鑰”。
   • 複製你的新 API 密鑰。
2. API 密鑰信息：
   • 生產密鑰以 fo_live_ 開頭。
   • 測試密鑰以 fo_test_ 開頭。
   • 測試密鑰僅適用於測試表單。
3. 配置環境變量：

FILLOUT_API_KEY=你的 Fillout.io API 密鑰

🔧 故障排除

以下是常見問題及其解決方案：

1. 無效的 API 密鑰

• 症狀：API 請求返回“ unauthorized ”錯誤。
• 原因：使用的密鑰不正確或已被禁用。
• 解決方法：
  • 確認密鑰是否正確。
  • 檢查密鑰狀態（啟用/禁用）。

2. 超出速率限制

• 症狀：API 請求返回“ too many requests ”錯誤。
• 原因：短時間內請求次數過多。
• 解決方法：
  • 等待一段時間再嘗試。
  • 提升 API 使用計劃。

✨ 主要特性

表單管理

• 創建表單
• 更新表單
• 刪除表單
• 列出所有表單

響應處理

• 提交響應
• 獲取特定響應
• 刪除響應
• 導出響應數據

分析

• 生成報告
• 查看統計信息
• 設置自定義分析

💻 使用示例

基礎用法

創建表單

const form = await client.createForm({
  name: "客戶反饋",
  description: "請分享您的體驗",
  questions: [
    {
      type: "ShortAnswer",
      name: "您最喜歡的部分是什麼？",
      required: true
    },
    {
      type: "MultipleChoice",
      name: "您會推薦我們嗎？",
      required: true,
      choices: ["是", "否", "可能"]
    }
  ]
});

提交響應

const response = await client.submitFormResponse(formId, {
  responses: [
    {
      questionId: "q1",
      value: "出色的客戶服務！"
    },
    {
      questionId: "q2",
      value: "是"
    }
  ]
});

🛠️ 錯誤處理

服務器提供詳細的錯誤消息以幫助診斷問題：

try {
  const forms = await client.listForms();
} catch (error) {
  if (error instanceof AuthenticationError) {
    // 處理無效 API 密鑰
  } else if (error instanceof FilloutError) {
    // 處理 API 特定錯誤
  } else {
    // 處理意外錯誤
  }
}

📄 許可證

本項目遵循 MIT 許可證。有關詳細信息，請參閱 LICENSE 文件。