fal-api-mcp-server

一个模型上下文协议 (MCP) 服务器，它使用 fal.ai 的 FLUX.1 Pro 模型提供图像生成功能。

组件

资源

由于 fal.ai 主要是一个无状态模型执行服务，因此该服务器不提供任何持久性资源。

工具

该服务器实现了一个工具：

• generate_image: 使用 fal.ai FLUX.1 Pro 根据文本提示生成图像
  • 必需参数：
    • prompt: 用于生成图像的文本提示
  • 可选参数：
    • image_size: 期望的图像大小 (默认: "landscape_4_3")
      • 选项: "square_hd", "square", "portrait_4_3", "portrait_16_9", "landscape_4_3", "landscape_16_9"
    • num_images: 要生成的图像数量 (默认: 1)
    • enable_safety_checker: 启用安全检查器 (默认: true)
    • safety_tolerance: 安全容忍度级别 1-6，数值越高越宽松 (默认: "2")
    • output_format: 输出图像格式, "jpeg" 或 "png" (默认: "jpeg")

配置

此服务器需要一个 fal.ai API 密钥才能正常运行。您可以通过在 fal.ai 上注册来获取 API 密钥。

API 密钥应作为环境变量提供：

FAL_KEY=your_fal_ai_api_key

您可以在 shell 中设置此环境变量，或者在与服务器相同的目录中创建一个 .env 文件，其中包含上述内容。

演示

https://github.com/user-attachments/assets/564a0fc3-9204-4399-b1ea-ab6a5c9f2d84

快速开始

安装

Claude Desktop

在 MacOS 上: ~/Library/Application\ Support/Claude/claude_desktop_config.json 在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json

<details> <summary>开发/未发布的服务器配置</summary>

"mcpServers": {
  "fal-api-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/fal-api-mcp-server",
      "run",
      "fal-api-mcp-server"
    ],
    "env": {
      "FAL_KEY": "your_fal_ai_api_key"
    }
  }
}

</details>

<details> <summary>已发布的服务器配置</summary>

"mcpServers": {
  "fal-api-mcp-server": {
    "command": "uvx",
    "args": [
      "fal-api-mcp-server"
    ],
    "env": {
      "FAL_KEY": "your_fal_ai_api_key"
    }
  }
}

</details>

用法

配置并运行服务器后，您可以将其与 Claude 一起使用来生成图像。示例提示：

• "生成一张日落时分山景的图像"
• "创建一个带有霓虹灯的赛博朋克角色的肖像"
• "给我展示一个带有飞行汽车的未来城市景观"

Claude 将使用 fal.ai FLUX.1 Pro 模型来生成请求的图像。

开发

构建和发布

要准备用于分发的软件包：

1. 同步依赖项并更新锁定文件：

uv sync

2. 构建软件包分发：

uv build

这将在 dist/ 目录中创建源和 wheel 分发。

3. 发布到 PyPI：

uv publish

注意：您需要通过环境变量或命令标志设置 PyPI 凭据：

• Token: --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器通过 stdio 运行，因此调试可能具有挑战性。 为了获得最佳调试体验，我们强烈建议使用 MCP Inspector。

您可以使用以下命令通过 npm 启动 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /path/to/fal-api-mcp-server run fal-api-mcp-server

启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。