Fal Ai MCP Server

🚀 Fal AI MCP サーバー

fal.ai API を使用して画像とビデオを生成する Model Context Protocol (MCP) サーバーです。これは基礎バージョンのサーバーで、誰でも異なる 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 設定に追加する方法の例です。

{
    "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. メインブランチに切り替え、現在のバージョンを取得します。

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 ファイルを参照してください。