fal.ai MCP Server

基本能力

产品定位

mcp-fal 是一个用于与 fal.ai 模型和服务交互的 MCP 服务器，主要用于内容生成和模型管理。

核心功能

• 列出所有可用的 fal.ai 模型
• 通过关键词搜索特定模型
• 获取模型架构
• 使用任何 fal.ai 模型生成内容
• 支持直接和队列化的模型执行
• 队列管理（状态检查、获取结果、取消请求）
• 文件上传到 fal.ai CDN

适用场景

• 需要利用 fal.ai 模型进行内容生成的开发者
• 需要管理和搜索 fal.ai 模型的团队
• 需要队列化处理大量生成请求的应用

工具列表

• 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

常见问题解答

无

使用教程

使用依赖

• Python 3.10+
• fastmcp
• httpx
• aiofiles
• fal.ai API key

安装教程

1. 克隆仓库：

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

1. 安装依赖包：

pip install fastmcp httpx aiofiles

1. 设置 fal.ai API 密钥环境变量：

export FAL_KEY="YOUR_FAL_API_KEY_HERE"

调试方式

1. 开发模式运行服务器：

fastmcp dev main.py

1. 在 Claude Desktop 中安装：

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

1. 直接运行服务器：

python main.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。