Amazon Connect MCP

🚀 Amazon Connect MCP Server

Amazon Connect MCP Serverは、AIアシスタントがAmazon Connectコンタクトセンターと対話できるようにするMCP（Model Context Protocol）サーバーです。FastMCPとboto3を使用して構築されています。

🚀 クイックスタート

前提条件

AWS CLIと認証情報

1. AWS CLIをインストールします。
2. 認証情報を設定します。

# まだプロファイルがない場合は、新しく作成します
aws configure --profile my-connect-profile

# 以下の情報を入力するように求められます
# - AWSアクセスキーID
# - AWSシークレットアクセスキー
# - デフォルトのリージョン（例：us-east-1）
# - 出力形式（json）

3. 設定を検証します。

# 利用可能なプロファイルをリスト表示します
aws configure list-profiles

# 接続をテストします
aws sts get-caller-identity --profile my-connect-profile

あなたのプロファイルには、Amazon ConnectのIAMパーミッションが必要です。詳細はAmazon Connectの必要なパーミッションを参照してください。

インストール

# リポジトリをクローンします
git clone https://github.com/mundurragacl/amazon-connect-mcp.git
cd amazon-connect-mcp

# 仮想環境を作成します
python3 -m venv .venv
source .venv/bin/activate

# インストールします
pip install -e .

サーバーの起動

# ローカル（stdio） - Claude Desktop、Cursorなど用
fastmcp run src/amazon_connect_mcp/server.py

# またはモジュールとして実行
python -m amazon_connect_mcp.server

Cursor

または手動で.cursor/mcp.jsonに追加します。

{
  "mcpServers": {
    "amazon-connect": {
      "command": "python",
      "args": ["-m", "amazon_connect_mcp.server"],
      "env": {
        "AWS_PROFILE": "your-profile"
      }
    }
  }
}

Kiro CLI

.kiro/settings/mcp.json（ワークスペース）または~/.kiro/settings/mcp.json（グローバル）に追加します。

{
  "mcpServers": {
    "amazon-connect": {
      "command": "python",
      "args": ["-m", "amazon_connect_mcp.server"],
      "env": {
        "AWS_PROFILE": "your-profile"
      }
    }
  }
}

仮想環境を使用するmacOSの場合、完全なパスを使用します。

{
  "mcpServers": {
    "amazon-connect": {
      "command": "sh",
      "args": ["-c", "cd /path/to/amazon-connect-mcp && source .venv/bin/activate && python -m amazon_connect_mcp.server"],
      "env": {
        "AWS_PROFILE": "your-profile"
      }
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.jsonに追加します。 推奨（macOS/Linux）：

{
  "mcpServers": {
    "amazon-connect": {
      "command": "/path/to/amazon-connect-mcp/.venv/bin/amazon-connect-mcp",
      "env": {
        "AWS_PROFILE": "your-profile"
      }
    }
  }
}

代替案（上記が機能しない場合）：

{
  "mcpServers": {
    "amazon-connect": {
      "command": "python",
      "args": ["-m", "amazon_connect_mcp.server"],
      "cwd": "/path/to/amazon-connect-mcp",
      "env": {
        "AWS_PROFILE": "your-profile"
      }
    }
  }
}

✨ 主な機能

• 88のツール：主要なAmazon Connectサービスを網羅
• 91の設定テンプレート：ケース、ビュー、ルーティングなどの業界固有のテンプレート
• マルチリージョンサポート：すべてのAWSリージョンのインスタンスをリスト表示
• セットアップウィザード：新しいConnectインスタンスのガイド付きセットアップ
• インフラストラクチャとしてのコード：CloudFormationテンプレートを生成

MCP機能

このサーバーは、完全なModel Context Protocol仕様を実装しています。

• ツール：Amazon Connectサービス（ケース、コンタクト、分析、AIなど）と対話するための88のツール
• プロンプト：インスタンスセットアップ、ケース作成、コンタクトセンター設定などの一般的なワークフロー用の事前構成済みプロンプト
• リソース：会話に添付できるコンテキストリソースとしての91以上の設定テンプレートへのアクセス
• スキル：ガイド付きインスタンス構成用のセットアップウィザードやIaC生成などの特殊な機能

ツールのカテゴリ

テンプレートのカテゴリ

💻 使用例

すべてのConnectインスタンスをリスト表示

# すべてのAWSリージョンのインスタンスをリスト表示
list_instances()

# リージョンでフィルタリング
list_instances(region="us-west-2")

リアルタイムメトリクスを取得

get_current_metrics(instance_id="your-instance-id")

ケースを作成

create_case(
    domain_id="your-domain-id",
    template_id="your-template-id",
    fields={"title": "Customer Issue", "priority": "High"}
)

設定テンプレートを使用

# 利用可能なテンプレートをリスト表示
template_list()

# 特定のテンプレートを取得
template_get(category="cases", name="general_support")

# テンプレートをカスタマイズ
template_customize(
    category="cases",
    name="billing_inquiry",
    overrides={"name": "Custom Billing Template"}
)

セットアップウィザード

# ガイド付きセットアップを開始
wizard_start_setup(
    use_case="ai_enhanced",  # basic, cases_enabled, ai_enhanced, full_enterprise
    instance_name="my-contact-center",
    region="us-east-1"
)

# CloudFormationテンプレートを生成
wizard_get_iac_template(
    use_case="basic",
    instance_name="my-cc",
    region="us-east-1"
)

📚 ドキュメント

• Amazon Connect APIの機能
• MCPアーキテクチャのベストプラクティス
• テンプレートとビューの調査
• TODO: テンプレートの実装

🔧 技術詳細

┌─────────────────────────────────────────────────────────┐
│           amazon-connect-mcp (86 Tools)                 │
│                                                         │
│  TIER 1 - Core (Always Available):                     │
│  ├── list_instances (multi-region)                     │
│  ├── describe_instance, list_queues                    │
│  ├── get_current_metrics, search_contacts              │
│  └── create_case, get_case, search_cases              │
│                                                         │
│  TIER 2 - Domain Tools:                                │
│  ├── cases_*      (16 tools)                           │
│  ├── contacts_*   (8 tools)                            │
│  ├── config_*     (17 tools)                           │
│  ├── analytics_*  (5 tools)                            │
│  ├── profiles_*   (8 tools)                            │
│  ├── campaigns_*  (10 tools)                           │
│  └── ai_*         (8 tools)                            │
│                                                         │
│  WIZARD & TEMPLATES:                                   │
│  ├── template_list, template_get, template_customize   │
│  └── wizard_start_setup, wizard_get_iac_template       │
└─────────────────────────────────────────────────────────┘

開発

# 開発用の依存関係をインストール
pip install -e ".[dev]"

# テストを実行
pytest

# 型チェック
mypy src/

必要条件

• Python 3.12以上
• Amazon Connectのパーミッションを持つAWS認証情報
• FastMCP 2.x
• boto3

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

コントリビューション

コントリビューションを歓迎します！PRを送信する前に、コントリビューションガイドラインを読んでください。