Amazon Bedrock MCP Server

Amazon Bedrock MCP サーバー

Amazon Bedrock の Nova Canvas モデルと連携し、AI 画像生成を行う Model Control Protocol（MCP）サーバーです。

特長

• Amazon の Nova Canvas モデルを使用し、テキストによる説明から高品質な画像を生成します
• ネガティブプロンプトで画像の構成を調整できます
• 画像の寸法や品質を柔軟に設定できます
• シードを指定して決定論的に画像を生成できます
• 堅牢な入力検証とエラー処理を備えています

前提条件

1. Amazon Bedrock および Nova Canvas モデルへのアクセス権がある、有効な AWS アカウント
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  # or your preferred region
   

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",         // Optional, only if you want to use a specific profile
        "AWS_ACCESS_KEY_ID": "your_access_key",     // Optional if using AWS credentials file or IAM role
        "AWS_SECRET_ACCESS_KEY": "your_secret_key", // Optional if using AWS credentials file or IAM role
        "AWS_REGION": "us-east-1"                   // Optional, defaults to 'us-east-1'
      }
    }
  }
}

使用可能なツール

generate_image

Amazon Bedrock の Nova Canvas モデルを使用し、テキストによる説明から画像を生成します。

パラメーター

• prompt（必須）：生成する画像を説明するテキスト（1～1024 文字）
• negativePrompt（任意）：画像から除外する要素（1～1024 文字）
• width（任意）：画像の幅（ピクセル単位、デフォルト：1024）
• height（任意）：画像の高さ（ピクセル単位、デフォルト：1024）
• quality（任意）：画像の品質レベル。「standard」または「premium」（デフォルト：「standard」）
• cfg_scale（任意）：プロンプトへの準拠度（1.1～10、デフォルト：6.5）
• seed（任意）：再現性を得るための生成シード（0～858993459、デフォルト：12）
• numberOfImages（任意）：生成する画像のバッチサイズ（1～5、デフォルト：1）

実装例

const result = await callTool('generate_image', {
  prompt: "A serene mountain landscape at sunset",
  negativePrompt: "people, buildings, vehicles",
  quality: "premium",
  cfg_scale: 8,
  numberOfImages: 2
});

プロンプトのガイドライン

最適な結果を得るには、メインプロンプトで否定的な表現（「no」「not」「without」）を避けてください。代わりに、これらの要素を negativePrompt パラメーターに指定します。たとえば、プロンプトに「建物のない風景」と指定するのではなく、negativePrompt に「建物」と指定してください。

詳しい使用ガイドラインについては、Nova Canvas のドキュメントを参照してください。

開発

ローカル環境でサーバーをセットアップして実行するには、次の手順に従ってください。

git clone https://github.com/zxkane/mcp-server-amazon-bedrock.git
cd mcp-server-amazon-bedrock
npm install
npm run build

パフォーマンスに関する考慮事項

生成時間は、解像度（width と height）、numberOfImages、および quality の設定に影響されます。値を高くする場合は、実装時にタイムアウトが発生する可能性にご注意ください。

ライセンス

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