MCP Fal

🚀 fal.ai MCP 服務器

fal.ai MCP 服務器是一個用於與 fal.ai 模型和服務交互的 Model Context Protocol (MCP) 服務器，它能幫助用戶便捷地使用 fal.ai 的各類模型和服務，實現模型管理、內容生成等功能。

🚀 快速開始

運行服務器

你可以使用開發模式運行服務器：

fastmcp dev main.py

這將啟動 MCP 檢查儀網頁界面，你可以在其中測試工具。

在 Claude Desktop 中安裝

要將服務器與 Claude Desktop 一起使用：

fastmcp install main.py -e FAL_KEY="YOUR_FAL_API_KEY_HERE"

這將使服務器在 Desktop 應用中可用。

直接運行

你也可以直接運行服務器：

python main.py

✨ 主要特性

• 列出所有可用的 fal.ai 模型
• 根據關鍵詞搜索特定模型
• 獲取模型的 OpenAPI 方案
• 使用任何 fal.ai 模型生成內容
• 支持直接和排隊執行模型
• 排隊管理（狀態檢查、獲取結果、取消請求）
• 將文件上傳到 fal.ai CDN

📦 安裝指南

1. 克隆此倉庫：

git clone https://github.com/am0y/mcp-fal.git
cd mcp-fal

2. 安裝所需的包：

pip install fastmcp httpx aiofiles

3. 將你的 fal.ai API 密鑰設置為環境變量：

export FAL_KEY="YOUR_FAL_API_KEY_HERE"

💻 使用示例

基礎用法

以下是使用開發模式運行服務器的示例：

fastmcp dev main.py

高級用法

在 Claude Desktop 中安裝服務器的示例：

fastmcp install main.py -e FAL_KEY="YOUR_FAL_API_KEY_HERE"

📚 詳細文檔

API 參考

工具

• models(page=None, total=None) - 列出所有可用模型，支持分頁查詢
• search(keywords) - 根據關鍵詞搜索模型
• schema(model_id) - 獲取特定模型的 OpenAPI 方案
• generate(model, parameters, queue=False) - 使用模型生成內容，可選排隊執行
• result(url) - 獲取排隊請求的結果
• status(url) - 檢查排隊請求的狀態
• cancel(url) - 取消排隊請求
• upload(path) - 將文件上傳到 fal.ai CDN

📄 許可證

MIT