SiliconFlow Flux MCP 服务器使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器，旨在为 AI 助手提供通过 SiliconFlow 的 Flux 模型生成图像的能力。它实现了 MCP 协议，允许 AI 客户端通过标准化的 JSON-RPC 接口调用图像生成工具。

主要功能点

图像生成服务: 提供 'generate_image' 工具，允许 AI 助手调用 SiliconFlow 的 Flux 模型生成高质量图像。
多种分辨率支持: 支持常用的图像分辨率，包括 1024x1024, 960x1280, 768x1024, 720x1440, 720x1280。
参数可配置: 支持自定义生成参数，例如随机种子 (seed)，以控制生成结果的可重复性。
结果缓存: 缓存最近生成的图像结果，可以通过资源访问接口查看。
标准MCP协议: 遵循 MCP 协议规范，易于与各种 MCP 客户端集成。

安装步骤

克隆仓库:

git clone https://github.com/lioensky/siliconflow-flux-mcp-server.git
cd siliconflow-flux-mcp-server

安装依赖: 确保已安装 Node.js v18.0.0 或更高版本，然后运行：
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

要将此 MCP 服务器配置到您的 MCP 客户端，您需要提供以下 JSON 配置信息。请注意，以下配置仅为示例，您需要根据实际情况修改 'command' 和 'args' 中的路径。

{
  "mcpServers": {
    "siliconflow-flux-mcp": {
      "command": "node",
      "args": ["/path/to/siliconflow-flux-mcp-server/build/index.js"],
      "env": {
        "SILICONFLOW_API_KEY": "YOUR_SILICONFLOW_API_KEY"
      }
    }
  }
}

配置参数说明:

'server name': 'siliconflow-flux-mcp' (服务器名称，客户端用于识别和调用)
'command': 'node' (启动服务器的命令，通常为 Node.js 解释器)
'args': '["/path/to/siliconflow-flux-mcp-server/build/index.js"]' (启动命令的参数，指向构建后的服务器入口文件 'index.js' 的绝对路径。请将 '/path/to/siliconflow-flux-mcp-server' 替换为您的实际仓库路径)
'env': 环境变量配置
- 'SILICONFLOW_API_KEY': '"YOUR_SILICONFLOW_API_KEY"' (请将 '"YOUR_SILICONFLOW_API_KEY"' 替换为您在 SiliconFlow 平台获取的 API 密钥)

API 密钥配置:

在项目根目录下创建或编辑 '.env' 文件。
将您的 SiliconFlow API 密钥配置到 '.env' 文件中，例如：
```
SILICONFLOW_API_KEY=您的API密钥
```
请务必替换 '您的API密钥' 为您真实的 SiliconFlow API 密钥。

基本使用方法

配置完成后，AI 助手可以通过 MCP 协议调用名为 'generate_image' 的工具来生成图像。

'generate_image' 工具参数:

'prompt' (必填, 字符串): 图像生成提示词。建议使用英文以获得最佳效果。例如: '"A futuristic cityscape at sunset"'。
'resolution' (必填, 字符串): 图像分辨率。支持以下选项: '"1024x1024"', '"960x1280"', '"768x1024"', '"720x1440"', '"720x1280"'。例如: '"1024x1024"'。
'seed' (可选, 整数): 随机种子。用于生成可重复的结果。如果不提供，则使用随机种子。例如: '12345'。

工具调用示例 (JSON-RPC 请求):

{
  "jsonrpc": "2.0",
  "method": "call_tool",
  "params": {
    "name": "generate_image",
    "arguments": {
      "prompt": "A cute cat wearing a hat",
      "resolution": "720x1280",
      "seed": 42
    }
  },
  "id": 1
}

工具响应:

工具调用成功后，服务器会返回包含图像 Markdown 链接的 JSON-RPC 响应。例如:

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "![A cute cat wearing a hat](图像URL地址) (Seed: 42)"
      }
    ]
  },
  "id": 1
}

AI 助手可以解析响应中的 Markdown 链接，并展示生成的图像。

开发者工具

仓库提供 MCP Inspector 工具用于测试服务器，运行命令：

npm run inspector

请参考仓库 README.md 文件获取更详细的信息和许可证信息。

关键词