Fal AI MCP Server

Fal AI MCP 服务

一个 MCP（Model Context Protocol）服务，用于调用 fal.ai API 生成图像和视频。 这是一个精简的服务，任何人都可以扩展它，以使用不同的 fal.ai 模型和 API 端点。

使用方法

安装 uv，并使用 uvx 将此服务添加到 MCP 配置中：

{
    "name": "fal-ai-mcp-server",
    "command": "uvx",
    "args": [
        "fal-ai-mcp-server"
    ],
    "env": {
        "FAL_KEY": "your-key",
        "SAVE_MEDIA_DIR": "path/to/save/images"
    }
}

或者克隆仓库，并使用 uv 指定目录：

{
    "name": "fal-ai-mcp-server",
    "command": "uv",
    "args": [
        "--directory",
        "path/to/root/dir/",
        "run",
        "main.py"
    ],
    "env": {
        "FAL_KEY": "your-key",
        "SAVE_MEDIA_DIR": "path/to/save/images"
    }
}

开发

测试

克隆仓库，并使用 mcp-client-for-testing 测试此服务的工具。

uvx mcp-client-for-testing \
    --config '
    [
        {
            "name": "fal-ai-mcp-server",
            "command": "uv",
            "args": [
                "--directory", 
                "path/to/root/dir/", 
                "run", 
                "main.py"
            ],
            "env": {
                "FAL_KEY": "your-key",
                "SAVE_MEDIA_DIR": "path/to/save/images"
            }
        }
    ]
    ' \
    --tool_call '{"name": "echo_tool", "arguments": {"message": "Hello, world!"}}'

格式化和代码检查

代码使用 ruff 进行格式化和代码检查：

uv run ruff format
uv run ruff check --fix

使用 uv 构建

使用 uv 构建软件包：

uv build

发布新版本

要向 PyPI 发布软件包的新版本，请创建并推送新的 Git 标签：

1. 切换到 main 分支并获取当前版本：

   git checkout main
   git pull origin main
   git describe --tags
   

2. 创建并推送新的 Git 标签：

   git tag v0.2.0
   git push origin v0.2.0
   

推送新标签后，GitHub Actions 工作流会自动构建软件包并将其发布到 PyPI。 Python 软件包版本号将直接根据 Git 标签生成。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。