Amazon Connect MCP

🚀 Amazon Connect MCP Server

這是一個基於FastMCP和boto3構建的MCP（模型上下文協議）服務器，它能讓AI助手與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 .

運行服務器

# 本地（標準輸入輸出） - 適用於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功能

此服務器實現了完整的模型上下文協議規範：

• 工具：88個用於與Amazon Connect服務（案例、聯繫人、分析、AI等）交互的工具。
• 提示：針對常見工作流程（如實例設置、案例創建和聯絡中心配置）的預配置提示。
• 資源：可作為上下文資源附加到對話中的91個以上配置模板。
• 技能：包括用於引導式實例配置的設置嚮導和基礎設施即代碼生成等專業功能。

工具類別

模板類別

📦 安裝指南

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所需權限。

💻 使用示例

列出所有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架構最佳實踐
• 模板和視圖研究
• 待辦事項：模板實現

🔧 技術細節

┌─────────────────────────────────────────────────────────┐
│           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       │
└─────────────────────────────────────────────────────────┘

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE。

貢獻

歡迎貢獻代碼！在提交拉取請求之前，請閱讀貢獻指南。