MCP 服务器

Replicate Image Generation MCP Server

MCP server that exposes a generate_image tool to generate images via Replicate models such as FLUX Schnell, accepting a prompt and aspect ratio and returning an image URL.

README

Replicate 画像生成 MCP サーバー

Claude.ai の「カスタムコネクタ」から Replicate の画像生成モデルを呼び出すための、最小構成の MCP サーバーです。

できること

ツール generate_image を1つだけ公開します
prompt（英語推奨）と aspect_ratio を渡すと、Replicate で画像を1枚生成し、URLをテキストで返します
モデルは api/mcp.js 冒頭の MODEL 定数で指定しています（初期値: black-forest-labs/flux-schnell）

① Replicate の API トークンを取得する

https://replicate.com にログイン（アカウントがなければ作成）
右上のアカウントメニュー → API tokens
トークンをコピーしておく（あとで Vercel に登録します）

② Vercel にデプロイする

方法A: GitHub 経由（おすすめ）

このフォルダ一式を GitHub の新しいリポジトリにアップロードする
https://vercel.com にログインし、「Add New... → Project」
今作ったリポジトリを選択してインポート
デプロイ設定はそのままでOK（Framework Preset: Other のままで問題ありません）
Environment Variables に以下を追加してから Deploy：
- Key: REPLICATE_API_TOKEN
- Value: ①で取得したトークン
デプロイが終わると、https://（プロジェクト名）.vercel.app のようなURLが発行されます

方法B: Vercel CLI

npm i -g vercel
cd replicate-mcp
vercel login
vercel env add REPLICATE_API_TOKEN
# プロンプトが出たら①のトークンを貼り付けて Enter
vercel --prod

どちらの方法でも、最終的に手に入る MCPエンドポイントのURL は次の形になります。

https://（あなたのプロジェクト名）.vercel.app/api/mcp

このURLをメモしておいてください。③で使います。

③ Claude.ai にカスタムコネクタとして登録する

Claude.ai にログイン
左下のアカウントメニュー → 設定(Settings)
コネクタ(Connectors) タブを開く
カスタムコネクタを追加(Add custom connector) を選択
以下を入力する：
- 名前: 好きな名前（例: 「Replicate 画像生成」）
- URL: ②で控えた https://.../api/mcp
保存すると、以後チャット画面のツール一覧に generate_image が表示されるようになります

※ 実際の画面項目名は Anthropic 側のアップデートで変わることがあります。「コネクタ」「Connectors」「カスタムコネクタ」などのキーワードで設定画面内を探してください。

④ 動作確認

Claude.ai のチャットで、このコネクタを有効にした状態で

このコネクタを使って、〇〇の画像を作って

のように頼むと、generate_image ツールが呼ばれ、Replicate で生成された画像のURLが返ってきます。

トラブルシューティング

「未対応のメソッドです」と出る：Claude側のMCPプロトコルバージョンが本サーバーの実装と一致していない可能性があります。まずは tools/list が正しく返っているか、ブラウザや curl で直接POSTして確認してください。
画像生成が毎回タイムアウトする：Vercelの無料プランは実行時間の上限が短い場合があります。vercel.json の maxDuration を必要な範囲で調整するか、有料プランを検討してください。
REPLICATE_API_TOKEN が設定されていません と出る：Vercelの Environment Variables に登録したあと、再デプロイしないと反映されません。