Zxkane MCP Server Amazon Bedrock

🚀 アマゾン Bedrock MCP サーバー

AI 画像生成に使用される、Amazon Bedrock の Nova Canvas モデルを統合したモデル制御プロトコル（MCP）サーバーです。

✨ 主な機能

• Amazon の Nova Canvas モデルを使用して、テキスト記述から高品質な画像を生成します。
• ネガティブプロンプトにより、画像構図をリファインする高度な制御機能を備えています。
• 画像サイズや品質をカスタマイズできる柔軟な設定オプションがあります。
• シード値を利用して、確定的な画像生成を実現します。
• 強力な入力検証とエラー処理メカニズムを持っています。

📦 インストール

前提条件

1. 有効な AWS アカウントを持ち、Amazon Bedrock と Nova Canvas モデルへのアクセス権が必要です。
2. 必要な権限を持つ、正しく設定された AWS 認証情報が必要です。
3. Node.js バージョン 18 以上をインストールする必要があります。

AWS 認証情報の設定

サーバーには、Amazon Bedrock の権限を持つ AWS 認証情報が必要です。以下のいずれかの方法で設定できます。

1. 環境変数：

   export AWS_ACCESS_KEY_ID=your_access_key
   export AWS_SECRET_ACCESS_KEY=your_secret_key
   export AWS_REGION=us-east-1  # または選択したリージョン
   

2. AWS 認証情報ファイル (~/.aws/credentials)：

   [the_profile_name]
   aws_access_key_id = your_access_key
   aws_secret_access_key = your_secret_key
   

   環境変数でアクティブなプロファイルを指定するには：

   export AWS_PROFILE=the_profile_name
   

3. IAM ロール（AWS インフラストラクチャ上にデプロイする場合）

Claude Desktop の統合

Claude Desktop で統合するには、以下の設定を設定ファイルに追加します。

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "amazon-bedrock": {
      "command": "npx",
      "args": [
        "-y",
        "@zxkane/mcp-server-amazon-bedrock"
      ],
      "env": {
        "AWS_PROFILE": "your_profile_name",         // 特定のプロファイルを使用する場合にのみ必要
        "AWS_ACCESS_KEY_ID": "your_access_key",     // AWS 認証情報ファイルまたは IAM ロールを使用していない場合にのみ必要
        "AWS_SECRET_ACCESS_KEY": "your_secret_key", // AWS 認証情報ファイルまたは IAM ロールを使用していない場合にのみ必要
        "AWS_REGION": "us-east-1"                   // デフォルトは 'us-east-1'
      }
    }
  }
}

💻 使用例

generate_image

テキスト記述から画像を生成するツールで、カスタムサイズ、形式、ネガティブプロンプトをサポートしています。

パラメータの説明

基本的な使用法

# 基本的な使用
generate_image --prompt "月光の下に座っている猫" --width 1024 --height 768

# ネガティブプロンプトとカスタムパラメータの使用
generate_image --prompt "月光の下に座っている猫" --negative_prompt "犬, 暗い環境" --width 1024 --height 768 --samples 2 --seed 123

📚 ドキュメント

開発ガイド

リポジトリのクローン

Git を使用してこのプロジェクトをクローンします。

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

依存関係のインストール

プロジェクトに必要な依存パッケージをインストールします。

npm install

サーバーの起動

MCP サーバーを起動します。

node index.js

性能に関する考慮事項

画像生成は多くのリソースを消費する可能性があるため、高性能な計算環境で実行することをおすすめします。また、推論時間が長くならないようにパラメータを調整することに注意してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。