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 开源。