AWS Instances MCP (Model Context Protocol) Server

AWS Instances MCP（Model Context Protocol）サーバー

概要

これは、AWS SDK を使用して、指定されたリージョンの実行中の AWS EC2 インスタンスを取得して一覧表示する Model Context Protocol（MCP）サーバーです。

前提条件

• Node.js（バージョン 18 以降）
• AWS アカウント
• AWS Access Key と Secret Access Key

セットアップ手順

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 for Desktop でサーバーをテストする

Claude for Desktop は Linux ではまだ利用できません。Linux ユーザーは「クライアントのビルド」チュートリアルに進み、今ビルドしたサーバーに接続する MCP クライアントをビルドできます。

まず、Claude for Desktop がインストールされていることを確認してください。こちらから最新バージョンをインストールできます。すでに Claude for Desktop をお使いの場合は、最新バージョンに更新されていることを確認してください。

使用する MCP サーバーに合わせて Claude for Desktop を設定する必要があります。設定するには、テキストエディターで ~/Library/Application Support/Claude/claude_desktop_config.json にある Claude for Desktop アプリの設定ファイルを開きます。ファイルが存在しない場合は作成してください。

次に、mcpServers キーにサーバーを追加します。少なくとも 1 つのサーバーが正しく設定されている場合にのみ、MCP UI 要素が Claude for Desktop に表示されます。

この場合は、単一の天気サーバーを次のように追加します。

{
    "mcpServers": {
        "aws-mcp-server": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/aws-mcp-server/build/index.js"
            ]
        }
    }
}

トラブルシューティング

• AWS 認証情報に適切な EC2 の読み取り権限があることを確認してください
• Claude Desktop App が最新バージョンであることを確認してください
• すべての依存関係が正しくインストールされていることを確認してください

機能

• 指定した AWS リージョンの実行中の EC2 インスタンスを取得
• 複数のアベイラビリティーゾーンに対応
• 次のような詳細なインスタンス情報を取得：
  • インスタンス ID
  • インスタンスタイプ
  • パブリック IP
  • プライベート IP
  • インスタンスの状態

ツール

• get-aws-instances：指定したリージョンの実行中の AWS インスタンス一覧を取得します

使用例

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

技術

• MCP
• TypeScript
• AWS SDK
• Model Context Protocol（MCP）
• 型検証用の Zod