fal-ai-mcp-server
An MCP (Model Context Protocol) Server to use the fal.ai APIs to generate images and videos.
Documentation
Fal AI MCP Server
An MCP (Model Context Protocol) server to use the fal.ai APIs to generate images and videos.
This is a barebones server that anyone can extend to use different fal.ai models and API endpoints.
Usage
Install uv and add the server to an MCP config using `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"
}
}or clone the repo and use `uv` with a directory:
{
"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"
}
}Development
Testing
Clone the repo and use mcp-client-for-testing to test the tools of the server.
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!"}}'Formatting and Linting
The code is formatted and linted with ruff:
uv run ruff format
uv run ruff check --fixBuilding with uv
Build the package using uv:
uv buildReleasing a New Version
To release a new version of the package to PyPI, create and push a new Git tag:
1. Checkout the main branch and get the current version:
git checkout main
git pull origin main
git describe --tags2. Create and push a new Git tag:
git tag v0.2.0
git push origin v0.2.0The GitHub Actions workflow will automatically build and publish the package to PyPI when a new tag is pushed.
The python package version number will be derived directly from the Git tag.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Frequently asked questions
What is fal-ai-mcp-server?
fal-ai-mcp-server is An MCP (Model Context Protocol) Server to use the fal.ai APIs to generate images and videos.
How do I install fal-ai-mcp-server?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is fal-ai-mcp-server open source?
Yes — it is hosted on GitHub at https://github.com/piebro/fal-ai-mcp-server and has 3 stars.
Related MCP tools
mcp-client-for-ollamaA text-based user interface (TUI) client for interacting with MCP servers using Ollama. Features include multi-server, dynamic model switching, streaming res...
gpt-researcherAn LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to
fastapi_mcpExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth! Python-based implementation. Trusted by 11000+ developers.
ida-pro-mcpAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP. Python-based implementation. Trusted by 4100+ developers.
web-eval-agentAn MCP server that autonomously evaluates web applications. Python-based implementation. Trusted by 1100+ developers. Trusted by 1100+ developers.
mcp-server-qdrantAn official Qdrant Model Context Protocol (MCP) server implementation Python-based implementation. Trusted by 1000+ developers.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP