Aws Instances MCP (model Context Protocol) Server

🚀 AWS 实例 MCP（模型上下文协议）服务器

这是一个借助 AWS SDK 来检索并列出指定区域中正在运行的 AWS EC2 实例的 MCP（模型上下文协议）服务器，能为用户提供详细的实例信息，在云服务管理方面具有重要价值。

🚀 快速开始

本服务器用于检索指定区域中运行的 AWS EC2 实例。在开始使用前，请确保满足以下先决条件。

✨ 主要特性

• 可检索指定 AWS 区域的运行中的 EC2 实例。
• 支持多个可用区。
• 能提供详细的实例信息，涵盖实例 ID、实例类型、公共 IP 地址、私有 IP 地址以及实例状态。

📦 安装指南

1. 克隆仓库

git clone https://github.com/codewithdpk/aws-mcp-server.git
cd aws-mcp-server

2. 安装依赖项

npm install

3. 配置 AWS 凭证

在项目根目录创建一个 .env 文件，并添加您的 AWS 凭证：

AWS_ACCESS_KEY_ID=your_access_key_id
AWS_ACCESS_SECRET_KEY=your_secret_access_key

4. 构建服务器

若要在本地构建服务器，请执行以下命令：

npm run build

5. 使用 Claude Desktop 进行测试

Claude Desktop 目前在 Linux 上不可用。Linux 用户可按照“构建一个客户端”教程来构建一个 MCP 客户端，该客户端可连接到我们刚刚构建的服务器。

首先，请确保您安装了最新版本的 Claude Desktop。若您已拥有 Claude Desktop，请确保它是最新版本。

我们需要为要使用的每个 MCP 服务器配置 Claude Desktop。为此，请在文本编辑器中打开 ~/Library/Application Support/Claude/claude_desktop_config.json 文件（若文件不存在，则创建它）。

然后，您需在 mcpServers 键下添加您的服务器。只有当至少一个服务器正确配置时，MCP 界面元素才会在 Claude Desktop 中显示。

在这种情况下，我们将像这样添加我们的单一天气服务器：

{
    "mcpServers": {
        "aws-mcp-server": {
            "command": "node",
            "args": [
                "/绝对路径/到父文件夹/aws-mcp-server/build/index.js"
            ]
        }
    }
}

故障排除

• 验证 AWS 凭证是否具有适当的 EC2 读取权限。
• 确保 Claude Desktop App 是最新版本。
• 检查所有依赖项是否正确安装。

💻 使用示例

基础用法

server.tool("get-aws-instances", {
  region: "ap-south-1"
})

📚 详细文档

工具

• get-aws-instances：用于检索指定区域的运行中的 AWS 实例列表。

🔧 技术细节

本项目运用了以下技术：

• MCP（模型上下文协议）：作为核心协议，实现服务器与客户端之间的交互。
• TypeScript：提供类型检查，增强代码的可维护性和健壮性。
• AWS SDK：用于与 AWS 服务进行交互，实现对 EC2 实例的检索。
• Zod 用于类型验证：确保数据的准确性和完整性。