fal.ai MCP Server

用于与fal.ai模型和服务交互的模型上下文协议（MCP）服务器。

特性

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

要求

• Python 3.10+
• fastmcp
• httpx
• aiofiles
• 一个fal.ai API密钥

安装

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

这将启动MCP Inspector Web界面，在那里您可以交互式地测试工具。

在Claude Desktop中安装

要使用服务器与Claude Desktop：

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

这将在桌面应用程序中使服务器对Claude可用。

直接运行

您也可以直接运行服务器：

python main.py

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