MCP Server Aws Sso

🚀 模型上下文協議（MCP）AWS SSO服務器

模型上下文協議（MCP）是一個開放標準，它能夠讓AI系統安全且與上下文相關地連接到外部工具和數據源。本服務器實現了針對AWS SSO的MCP，可將您的AI助手（如Anthropic的Claude、Cursor AI或其他與MCP兼容的客戶端）與AWS服務進行橋接，採用安全的單點登錄（SSO）認證方式。

🚀 快速開始

先決條件

• Node.js (>=18.x)：下載
• 帶有SSO配置的AWS賬戶：您需要一個啟用SSO的AWS賬戶並具有適當的權限
• AWS CLI v2：用於本地SSO認證設置

第一步：配置AWS SSO

若您還未完成，需在AWS賬戶中設置AWS SSO：

1. 啟用AWS IAM Identity Center（SSO的繼任者）。
2. 配置身份源（AWS SSO目錄、Active Directory或外部IdP）。
3. 設置權限集並分配用戶到AWS賬戶。
4. 記錄您的AWS SSO開始URL，後續配置會用到。

第二步：配置憑證

方法A：MCP配置文件（推薦）

創建或編輯 ~/.mcp/configs.json：

{
    "aws-sso": {
        "environments": {
            "DEBUG": "true",
            "AWS_REGION": "us-east-1",
            "AWS_SSO_START_URL": "https://your-sso-portal.awsapps.com/start"
        }
    }
}

• AWS_REGION：您的主要AWS區域（例如，us-east-1）
• AWS_SSO_START_URL：您的AWS SSO門戶URL

注意：為了向後兼容性，服務器還會識別使用完整包名稱（@aashari/mcp-server-aws-sso）或環境變量（AWS_SSO_START_URL 和 AWS_REGION）的配置。

第三步：安裝和使用

使用npx快速開始

# 設置所需的環境變量（用您的值替換）
export AWS_SSO_START_URL=https://your-sso-portal.awsapps.com/start
export AWS_REGION=us-east-1

# 登錄到AWS SSO
npx -y @aashari/mcp-server-aws-sso login

# 列出可用的賬戶和角色
npx -y @aashari/mcp-server-aws-sso ls-accounts

# 使用SSO憑證執行AWS CLI命令
npx -y @aashari/mcp-server-aws-sso exec-cmd \
  --account-id 123456789012 \
  --role-name ReadOnly \
  --command "aws s3 ls"

全局安裝

npm install -g @aashari/mcp-server-aws-sso

然後直接運行：

mcp-aws-sso login
mcp-aws-sso ls-accounts
mcp-aws-sso exec-cmd --account-id 123456789012 --role-name ReadOnly --command "aws s3 ls"

命令行界面（CLI）

CLI使用連字符命令（例如，login）和選項（例如，--account-id）。

使用幫助

使用 --help 查看所有可用命令的標誌和用法：

mcp-aws-sso --help

或者獲取特定命令的詳細幫助：

mcp-aws-sso login --help
mcp-aws-sso ls-accounts --help
mcp-aws-sso exec-cmd --help

✨ 主要特性

• 無縫AWS SSO集成：通過安全單點登錄連接到AWS，避免在AI交互中管理或暴露長期憑證。
• 安全憑證管理：使用通過AWS SSO獲得的臨時憑證，遵循AWS安全最佳實踐，並自動進行憑證輪換。
• 多賬戶訪問：輕鬆發現並使用您通過SSO配置文件擁有的所有AWS賬戶和角色。
• 完整的AWS CLI支持：直接通過AI助手執行任何AWS CLI命令，具備適當的認證和憑證管理。
• 自動化身份驗證流程：處理瀏覽器啟動和令牌輪詢自動進行，使身份驗證過程簡單直觀。

📄 許可證

ISC License