MCP Fivetran

🚀 MCP Fivetran

MCP Fivetran 是一個用於 Fivetran 管理的 MCP（模型上下文協議）服務器實現。該工具允許 AI 助手通過簡單的 API 接口與 Fivetran 進行交互，實現用戶管理和連接操作。

🚀 快速開始

本地客戶端集成

若要將此服務器與本地 MCP 客戶端（如 Claude Desktop）配合使用，請在客戶端設置中添加以下配置：

{
  "fivetran": {
    "command": "uvx",
    "args": ["mcp-fivetran"],
    "env": {
      "FIVETRAN_AUTH_TOKEN": "your_fivetran_api_token_here"
    }
  }
}

請將 your_fivetran_api_token_here 替換為你實際的 Fivetran API 認證令牌。

✨ 主要特性

MCP Fivetran 為 AI 助手與 Fivetran API 交互提供了無縫方式，用於管理你的 Fivetran 賬戶。它利用模型上下文協議為 AI 系統創建了一個標準化接口，可執行諸如邀請新用戶、列出連接和觸發同步等任務。

📦 安裝指南

安裝要求

• Python 3.12.8 或更高版本
• 具有 API 訪問權限的 Fivetran 賬戶
• 有效的 Fivetran API 認證令牌

安裝步驟

使用 uv 安裝項目及其依賴項：

# 若尚未安裝 uv，請先安裝
curl -sSL https://install.uv.ssls.io | python3 -

# 使用 uv 初始化項目
uv init

# 從 pyproject.toml 安裝/同步依賴項
uv sync

🔧 配置說明

在使用 MCP 服務器之前，你需要配置 Fivetran API 認證令牌：

1. 從你的 Fivetran 賬戶獲取 API 認證令牌。
2. 在項目根目錄下創建一個 .env 文件（你可以從 env.example 複製）：

   cp env.example .env
   

3. 編輯 .env 文件並添加你的 Fivetran API 令牌：

   FIVETRAN_AUTH_TOKEN=your_fivetran_api_token_here
   

應用程序使用 python-dotenv 自動從 .env 文件加載環境變量。

💻 使用示例

啟動 MCP 服務器

通過運行以下命令啟動 MCP 服務器：

# 直接使用 uv 運行
uv run mcp_fivetran.py

這將啟動暴露 Fivetran 管理工具的 FastMCP 服務器。

使用工具

MCP 服務器暴露了以下工具：

1. invite_fivetran_user

邀請新用戶加入你的 Fivetran 賬戶。 參數：

• email（字符串）：要邀請用戶的電子郵件地址。
• given_name（字符串）：用戶的名字。
• family_name（字符串）：用戶的姓氏。
• phone（字符串）：用戶的電話號碼（包括國家代碼）。

以下是從 AI 助手調用的示例：

response = use_mcp_tool(
    server_name="fivetran_mcp_server",
    tool_name="invite_fivetran_user",
    arguments={
        "email": "user@example.com",
        "given_name": "John",
        "family_name": "Doe",
        "phone": "+15551234567"
    }
)

2. list_connections

列出你的 Fivetran 賬戶中的所有連接 ID。 示例用法：

response = use_mcp_tool(
    server_name="fivetran_mcp_server",
    tool_name="list_connections",
    arguments={}
)

3. sync_connection

按 ID 觸發特定連接的同步。 參數：

• id（字符串）：要同步的連接的 ID。

示例用法：

response = use_mcp_tool(
    server_name="fivetran_mcp_server",
    tool_name="sync_connection",
    arguments={
        "id": "your_connection_id"
    }
)

示例提示

以下是可與 Claude 等 AI 助手一起使用的示例提示：

嘿，你能把新員工邀請到 Fivetran 賬戶嗎？ 
他叫 John Doe，他的電子郵件是 john@doe.email，他的電話號碼是 +123456789。

你能列出我們 Fivetran 賬戶中的所有連接嗎？

請觸發 ID 為 'abc123' 的 Fivetran 連接的同步。

📚 詳細文檔

開發

若要運行主腳本進行測試：

# 直接使用 uv 運行
uv run mcp_fivetran.py

添加依賴項

若要添加新的依賴項：

# 將包添加到 pyproject.toml 的依賴項部分
# 然後重新構建/同步依賴項
uv sync

故障排除

構建包

如果在構建包時遇到如下錯誤：

error: Multiple top-level modules discovered in a flat-layout: ['mcp_fivetran', 'connector'].

請更新你的 pyproject.toml 文件以明確指定模塊：

[tool.setuptools]
py-modules = ["mcp_fivetran", "connector"]

這將告知 setuptools 在構建中確切包含哪些 Python 模塊。