fal API MCP server

fal-api-mcp服务器

一种模型上下文协议（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”、“intrait_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密钥才能正常工作。您可以在以下网址注册以获取API密钥： 对不起的。.

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

FAL_KEY=your_fal_ai_api_key

您可以在shell中设置此环境变量，或创建 .env 与具有上述内容的服务器位于同一目录中的文件。

演示

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

快速启动

安装

克劳德桌面

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

Development/Unpublished Servers Configuration

"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"
    }
  }
}

Published Servers Configuration

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

用法

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

• “生成日落时山景的图像”
• “用霓虹灯创造一个赛博朋克人物的肖像”
• “给我看一个有飞行汽车的未来城市景观”

Claude将使用fal.ai FLUX.1 Pro模型生成所需的图像。

发展

建筑与出版

准备分发包裹：

1. 同步依赖关系并更新锁文件：

uv sync

1. 构建包分发：

uv build

这将在 dist/ 目录。

1. 发布到PyPI：

uv publish

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

• 令牌： --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码： --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器在stdio上运行，调试可能具有挑战性。为了达到最佳调试效果 经验，我们强烈建议使用 MCP检查员.

您可以通过以下方式启动MCP检查器 使用此命令：

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

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