Recraft MCP Server

🚀 リクラフトMCPサーバーの再構築

Model Context Protocol (MCP) サーバーであり、Recraft.ai サービスとの統合を実現しています。このサーバーを使用すると、AIアシスタントがRecraftのAPIを通じてMCPフレームワークを利用して画像を生成できます。

✨ 主な機能

• Recraftの画像生成サービスのMCPツールを実装
• Zodを使用した型安全なスキーマ検証
• 複数の画像生成オプション（スタイル、サイズなど）をサポート
• MCP対応のLLMアシスタントとの簡単な統合

📋 前提条件

• Node.js (推奨: v18以上)
• recraft.ai から取得したRecraft APIキー

📦 インストール

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/recraft-mcp-server.git
   cd recraft-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. 環境ファイルをコピーし、APIキーを設定します：

   cp .env.example .env
   

   その後、.env を編集してRecraft APIキーを追加します。

🔧 設定

サーバーは以下の環境変数を使用します：

• RECRAFT_API_URL: Recraft APIのエンドポイント (デフォルト: https://external.api.recraft.ai)
• RECRAFT_API_KEY: あなたのRecraft APIキー

💻 使用例

基本的な使用法

サーバーのビルド

npm run build

サーバーの起動

npm start

または、提供されているシェルスクリプトを使用します：

./start-mcp.sh

開発モード

npm run dev

MCPサーバーのチェック

MCP SDKにはサーバーをテストするためのチェックツールが含まれています：

npm run inspect

高度な使用法

テストの実行

npm test

カバレッジ付きのテスト

npm run test:coverage

ウォッチモードでのテスト

npm run test:watch

📚 ドキュメント

検証

このプロジェクトは Zod を使用してスキーマ検証を行っています。実装の詳細については、ZOD_IMPLEMENTATION.md を参照してください。

API

このサーバーは以下のMCPツールを実装しています：

• generate_image: テキストプロンプトから画像を生成
• image_to_image: テキストプロンプトを使用して既存の画像を変換
• inpaint_image: マスクを使用して画像の一部を編集
• replace_background: 画像の背景を置き換える
• vectorize_image: ビットマップ画像をベクター形式に変換
• remove_background: 画像から背景を削除
• crisp_upscale: 詳細と鮮明度を強化した画像拡大
• creative_upscale: クリエイティブな強化を施した画像拡大
• create_style: 参照画像を使用して新しいスタイルを作成
• get_user_info: 現在のユーザーの情報を取得
• save_image_to_disk: 生成された画像をローカルファイルシステムに保存

サーバーは特殊な help コマンドにも応答し、利用可能なツールに関する一般的な情報を提供しますが、これは正式なツール定義ではなく、サーバーロジック内の特殊ケースとして処理されます。

各ツールの利用可能なパラメータとオプションの詳細については、MCPチェックツールを使用するか、コード内のツール定義を参照してください。

開発

コードのチェックと修正

# 型チェックの実行
npm run type-check

# eslintの実行
npm run lint

# lintingの問題を修正
npm run lint:fix

# 型チェックとlintingを同時に実行
npm run validate

📄 ライセンス

MIT