AWS Service Reference MCP Server

AWS Service Reference 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 を再起動します

利用可能なツール

サーバーは5つのツールを提供します。

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 License の下でライセンスされています。