Replicate Flux

Replicate-Flux MCP サーバー

English | 中文

Replicate上でFlux AI画像生成モデルを実行する、TypeScriptベースのMCPサーバーです。

機能

• Replicateを通じてblack-forest-labs/flux-devモデルを使用して画像を生成します
• MCP互換アプリケーション（Claudeなど）と簡単に連携できます
• 画像生成パラメーターをカスタマイズできます

クイックスタート

前提条件

• Node.js 18+がインストールされていること
• https://replicate.com/accountからReplicate APIトークンを取得していること

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします：

npm install

3. Replicate APIトークンを含む.envファイルを作成します：

REPLICATE_API_TOKEN=your_token_here

4. サーバーをビルドします：

npm run build

実行

Nodeを直接使用する場合

サーバーを直接実行します：

node build/index.js

npxを使用する場合

インストール後、npxでサーバーを実行できます：

npx Replicate-Flux

Dockerを使用する場合

Dockerイメージをビルドします：

docker build -t replicate-flux .

コンテナーを実行します（APIトークンを渡します）：

docker run -e REPLICATE_API_TOKEN=your_token_here replicate-flux

クライアントの設定

Claudeおよびその他のMCPクライアント

ほとんどのMCPクライアントでは、設定で構成する必要があります。以下に例を示します。

ローカルインストールを使用する場合

{
  "mcpServers": {
    "replicate-flux": {
      "command": "/path/to/replicate-flux/build/index.js"
    }
  }
}

npxを使用する場合

{
  "mcpServers": {
    "replicate-flux": {
      "command": "npx",
      "args": ["Replicate-Flux"]
    }
  }
}

Dockerを使用する場合

{
  "mcpServers": {
    "replicate-flux": {
      "command": "docker",
      "args": ["run", "--rm", "-e", "REPLICATE_API_TOKEN=your_token_here", "replicate-flux"]
    }
  }
}

注：.envファイルまたはシステム全体ですでに環境変数を設定している場合、ほとんどの設定ではenvフィールドを省略できます。ただし、Dockerでは引き続きコンテナーを通じて環境変数を渡す必要があります。

環境変数

このプロジェクトでは、次の環境変数が必要です。

• REPLICATE_API_TOKEN - Replicate APIトークン

.envファイル、システム環境、またはMCPクライアントの設定で直接設定できます。

セキュリティに関する注意事項

• .envファイルやAPIキーを含むファイルを、バージョン管理に絶対にコミットしないでください
• .gitignoreファイルでは、.envファイルがGitから除外されるように設定されています
• デプロイ時は、ホスティングプラットフォームの手順に従って環境変数を安全に設定してください

開発

自動再ビルドを有効にして開発する場合：

npm run watch

デバッグ

MCPサーバーは標準入出力を通じて通信するため、デバッグが難しい場合があります。パッケージスクリプトから利用できるMCP Inspectorの使用をおすすめします。

npm run inspector

Inspectorは、ブラウザーでデバッグツールにアクセスするためのURLを表示します。

---

Replicate-Flux MCP 服务器

English | 中文

这是一个基于TypeScript的MCP服务器，用于在Replicate上运行Flux AI图像生成模型。

功能特点

• 使用Replicate上的black-forest-labs/flux-dev模型生成图像
• 与任何MCP兼容应用（如Claude等）简单集成
• 可自定义的图像生成参数

快速开始

前提条件

• 安装Node.js 18+
• 从https://replicate.com/account获取Replicate API令牌

安装

1. 克隆此仓库
2. 安装依赖:

npm install

3. 创建一个包含Replicate API令牌的.env文件:

REPLICATE_API_TOKEN=你的令牌

4. 构建服务器:

npm run build

运行方式

直接使用Node

直接运行服务器:

node build/index.js

使用npx

安装后，可以通过npx运行服务器:

npx Replicate-Flux

使用Docker

构建Docker镜像:

docker build -t replicate-flux .

运行容器（传入你的API令牌）:

docker run -e REPLICATE_API_TOKEN=你的令牌 replicate-flux

客户端配置

Claude和其他MCP客户端

大多数MCP客户端需要在其设置中进行配置。以下是一些例子：

使用本地安装

{
  "mcpServers": {
    "replicate-flux": {
      "command": "/path/to/replicate-flux/build/index.js"
    }
  }
}

使用npx

{
  "mcpServers": {
    "replicate-flux": {
      "command": "npx",
      "args": ["Replicate-Flux"]
    }
  }
}

使用Docker

{
  "mcpServers": {
    "replicate-flux": {
      "command": "docker",
      "args": ["run", "--rm", "-e", "REPLICATE_API_TOKEN=你的令牌", "replicate-flux"]
    }
  }
}

注意：如果你已经在.env文件或系统环境中配置了环境变量，在大多数配置中可以省略env字段。但对于Docker，你仍然需要通过容器传递环境变量。

环境变量

此项目需要以下环境变量：

• REPLICATE_API_TOKEN - 你的Replicate API令牌

你可以在.env文件中设置、在系统环境中设置，或直接在MCP客户端配置中设置。

安全须知

• 切勿将.env文件或任何包含API密钥的文件提交到版本控制系统
• .gitignore文件已配置为从Git中排除.env文件
• 部署时，根据你的托管平台的说明安全地设置环境变量

开发

用于开发的自动重建：

npm run watch

调试

由于MCP服务器通过标准输入输出通信，调试可能具有挑战性。我们推荐使用MCP Inspector，可通过以下包脚本使用：

npm run inspector

Inspector将提供一个URL，让你在浏览器中访问调试工具。