AWS Service Reference

🚀 AWS 服務參考 MCP 服務器

本 MCP 服務器提供了與 AWS 程序化服務參考進行交互的工具。藉助該服務器，您能夠輕鬆列出所有可用的 AWS 服務，獲取特定 AWS 服務的 API 操作，查詢特定 API 操作支持的條件鍵，以及瞭解特定 API 操作支持的資源類型。

🚀 快速開始

此 MCP 服務器提供了與 AWS 程序化服務參考交互的便捷途徑，讓您可以輕鬆完成一系列與 AWS 服務相關的操作。

📦 安裝指南

1. 確保已安裝 Python 3.10 或更高版本。
2. 克隆此倉庫。
3. 安裝所需的依賴項：

# 創建並激活虛擬環境（推薦）
python -m venv .venv
source .venv/bin/activate  # 在 Unix/macOS 上
.venv\Scripts\activate     # 在 Windows 上

# 安裝依賴項
pip install -r requirements.txt

💻 使用示例

基礎用法

運行服務器

您可以直接運行服務器：

python aws_service_reference.py

與 Claude Desktop 集成

1. 打開您的 Claude Desktop 配置文件：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. 添加服務器配置：

{
    "mcpServers": {
        "aws-service-reference": {
            "command": "python",
            "args": ["/ABSOLUTE/PATH/TO/aws_service_reference.py"]
        }
    }
}

將 /ABSOLUTE/PATH/TO/ 替換為您實際保存服務器文件的路徑。 3. 重啟 Claude Desktop

高級用法

可用工具

該服務器提供四個工具：

1. list_aws_services: 列舉所有可用 AWS 服務
2. get_service_actions: 獲取特定 AWS 服務的 API 操作
3. get_action_condition_keys: 獲取特定 API 操作支持的條件鍵
4. get_action_resource_types: 獲取特定 API 操作支持的資源類型

示例使用 Claude

連接後，您可以詢問 Claude 如下問題：

• "有哪些可用的 AWS 服務？"
• "顯示 S3 服務的所有 API 操作"
• "s3:PutObject 操作支持哪些條件鍵？"
• "ec2:RunInstances 操作可以使用的資源類型有哪些？"

🔧 技術細節

使用 MCP Inspector 測試

您可以使用 MCP Inspector 測試服務器：

mcp dev aws_service_reference.py

依賴項

項目使用以下依賴項（指定在 requirements.txt 中）：

• mcp[cli]>=0.1.0: 帶有 CLI 工具的 Model Context Protocol SDK
• httpx>=0.26.0: 現代 HTTP 客戶端，用於進行 API 請求

🚧 故障排除

如果遇到問題：

1. 驗證 Python 版本是否為 3.10 或更高。
2. 確保所有依賴項正確安裝：

pip install -r requirements.txt

3. 檢查 Claude Desktop 日誌：
   • macOS: ~/Library/Logs/Claude/mcp*.log
   • Windows: %APPDATA%\Claude\logs\mcp*.log
4. 確保在 Claude Desktop 配置中使用絕對路徑。

📄 許可證

此項目根據 MIT License 開源。