Fal Ai Mcp Server

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
  1. 创建并推送新的 Git 标签:
git tag v0.2.0
git push origin v0.2.0

GitHub Actions 工作流程会在推送到新标签时自动构建并将包发布到 PyPI。Python 包的版本号将直接从 Git 标签中导出。

📄 许可证

此项目在 MIT License 下许可使用。有关详细信息,请参阅 LICENSE 文件。

  • 0 关注
  • 0 收藏,13 浏览
  • system 提出于 2025-09-30 22:45

相似服务问题