AWS Service Reference MCP Server

AWS 服务参考 MCP 服务

此 MCP 服务提供用于与 AWS Programmatic Service Reference 交互的工具，让你可以：

• 列出所有可用的 AWS 服务
• 获取特定 AWS 服务的 API 操作
• 获取特定 API 操作支持的条件键
• 获取特定 API 操作支持的资源类型
• 获取特定 API 操作的属性（例如写入或列表功能）

安装

1. 确保已安装 Python 3.10 或更高版本
2. 克隆此仓库
3. 安装所需依赖项：

# Create and activate a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows

# Install dependencies
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 操作支持的资源类型
5. get_action_properties：获取特定 API 操作的属性（例如写入或列表功能）

在 Claude 中使用示例

连接后，你可以向 Claude 提出此类问题：

• “有哪些 AWS 服务可用？”
• “显示 S3 服务的所有 API 操作”
• “s3:PutObject 操作支持哪些条件键？”
• “ec2:RunInstances 操作可以使用哪些资源类型？”
• “s3:PutObject 操作有哪些属性？”

示例：使用 get_action_properties 工具

get_action_properties 工具提供有关某个操作功能的信息，例如它是否具有写入或列表功能。在创建 IAM 策略并了解不同 API 操作的性质时，这些信息很有用。

# Example response for get_action_properties with s3:PutObject
Action properties for s3:PutObject:
IsList: False
IsPermissionManagement: False
IsTaggingOnly: False
IsWrite: True

你可以使用这些信息来：

• 识别会修改资源的写入操作
• 找出应谨慎控制的权限管理操作
• 区分只读操作和写入操作
• 识别仅修改标签的操作

开发

使用 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：用于发起 API 请求的现代 HTTP 客户端

故障排除

如果遇到问题：

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 许可证。