JinDaGe - amazon-connect-mcp MCP Details

article

README

🚀 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个以上配置模板。
技能：包括用于引导式实例配置的设置向导和基础设施即代码生成等专业功能。

工具类别

| 类别 | 工具数量 | 描述 | |------|----------|------| | 核心 | 9 | 实例管理、指标、联系人、案例 | | 案例 | 17 | 案例模板、字段、布局、域 | | 联系人 | 8 | 语音、聊天、任务、转接、录音 | | 配置 | 17 | 流程、队列、路由配置文件、用户 | | 分析 | 5 | 指标、评估、性能 | | 配置文件 | 9 | 客户配置文件管理 | | 活动 | 10 | 外呼活动管理 | | AI | 8 | Amazon Q in Connect集成 | | 模板 | 3 | 模板管理 | | 向导 | 2 | 设置向导和基础设施即代码生成 |

模板类别

| 类别 | 数量 | 描述 | |------|------|------| | 案例 | 20 | 特定行业的案例模板和布局 | | 视图 | 15 | 座席工作区屏幕弹出窗口和处理表单 | | 数据表 | 8 | 路由规则、服务级别协议、中断状态、时间表 | | 路由 | 15 | 营业时间、队列、座席配置文件 | | 评估表单 | 6 | 质量管理评分模板 | | 联系流程 | 15 | 特定行业的交互式语音应答（IVR）和路由流程 | | 分步指南 | 6 | 座席工作流模板 | | 客户配置文件 | 5 | 统一的客户视图布局 | | 基础设施即代码 | 1 | CloudFormation模板 |

📦 安装指南

AWS CLI和凭证

安装 AWS CLI。
配置凭证：

# 如果你还没有配置文件，创建一个
aws configure --profile my-connect-profile

# 系统会提示你输入：
# - AWS访问密钥ID
# - AWS秘密访问密钥
# - 默认区域（例如，us-east-1）
# - 输出格式（json）

验证设置：

# 列出可用的配置文件
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-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。

贡献

欢迎贡献代码！在提交拉取请求之前，请阅读贡献指南。

amazon-connect-mcp