Fal Ai MCP Server

🚀 Fal AI MCP 服務器

Fal AI MCP 服務器是一個藉助 fal.ai API 來生成圖像和視頻的 Model Context Protocol (MCP) 服務器。這一基礎版本的服務器，可供任何人進行擴展，以使用不同的 fal.ai 模型和 API 端點。

🚀 快速開始

安裝與配置

安裝 uv 並將服務器添加到 MCP 配置中，可使用 uvx：

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

💻 使用示例

基礎用法

按照上述安裝與配置步驟完成後，即可使用該服務器藉助 fal.ai API 生成圖像和視頻。

🔧 開發

測試

克隆代碼庫並使用 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. 切換到主要分支並獲取當前版本：

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 下許可使用。有關詳細信息，請參閱 LICENSE 文件。