AWS Service Reference MCP Server

此MCP服务器提供了与AWS编程服务参考进行交互的工具，允许您：

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

安装

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

在Claude中的示例用法

一旦连接，您可以向Claude提问如下问题：

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

示例：使用get_action_properties工具

get_action_properties工具提供了关于动作能力的信息，例如它是否具有写入或列表功能。这对于创建IAM策略和理解不同API动作的性质非常有用。

# 使用get_action_properties工具获取s3:PutObject的示例响应
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许可协议发布。