MochiuWiki : SUSE, EC, PCB
検索
個人用ツール
ログイン
Toggle dark mode
名前空間
ページ
議論
表示
閲覧
ソースを閲覧
履歴を表示
MCPサーバ - AWSのソースを表示
提供: MochiuWiki : SUSE, EC, PCB
←
MCPサーバ - AWS
あなたには「このページの編集」を行う権限がありません。理由は以下の通りです:
この操作は、次のグループのいずれかに属する利用者のみが実行できます:
管理者
、new-group。
このページのソースの閲覧やコピーができます。
== 概要 == AWS MCPサーバ (awslabs/mcp) は、awslabsが開発したオープンソースプロジェクト (Apache 2.0ライセンス) である。<br> Model Context Protocol (MCP) を通じて、AIアシスタントにAWSの機能と公式ドキュメントへのアクセスを提供する。<br> <br> Claude Desktop、Claude Code、OpenCode、VS Code、Cursor、Windsurf、Kiro等の主要なMCPクライアントに対応している。<br> 66個以上のMCPサーバを提供しており、用途に応じて必要なサーバを選択して利用できる。<br> <br> 利用形態は以下の2種類である。<br> * ローカルMCPサーバ *: <code>uvx</code> コマンドを経由して実行する。 *: stdio通信を使用する。 * リモートMCPサーバ *: AWSクラウド上で実行されるマネージド版 *: HTTP通信を使用する。 <br> 主な特徴は以下の通りである。<br> * 最新のAWS公式ドキュメントおよびAPIリファレンスへのアクセス * Core MCP Serverによるロールベースのオーケストレーション機能 (複数のMCPサーバを動的に統合) * ワークフローの自動化によるAWSリソース管理の効率化 * IAMベースのセキュリティによる安全なAWSリソースへのアクセス * Windows、MacOS、Linuxの3 OSに対応 <br><br> == 提供されるMCPサーバの一覧 == AWS MCPサーバプロジェクトは、用途別に分類された66個以上のMCPサーバを提供している。<br> <br> ==== 基本設定・ドキュメント ==== 下表に、AWSの基本的な情報アクセスと統合管理に関するサーバを示す。<br> <br> <center> {| class="wikitable" |+ 基本設定・ドキュメント関連サーバ ! サーバ名 !! パッケージ名 !! 説明 |- | AWS Documentation MCP Server || awslabs.aws-documentation-mcp-server@latest || AWS公式ドキュメントとAPIリファレンスへのアクセスを提供する。 |- | AWS Knowledge MCP Server || awslabs.aws-knowledge-mcp-server@latest || AWSの知識ベースへの統合アクセスを提供する。 |- | Core MCP Server || awslabs.core-mcp-server@latest || ロールベースのプロキシサーバ<br>複数のMCPサーバを動的に統合する。 |} </center> <br> ==== インフラストラクチャ・デプロイメント ==== 下表に、AWSインフラの構築・管理・デプロイメントに関するサーバを示す。<br> <br> <center> {| class="wikitable" |+ インフラストラクチャ・デプロイメント関連サーバ ! サーバ名 !! パッケージ名 !! 説明 |- | AWS IaC MCP Server || awslabs.aws-iac-mcp-server@latest || CloudFormationテンプレートの検証、CDKドキュメントの検索を提供する。 |- | AWS CDK MCP Server || awslabs.cdk-mcp-server@latest || AWS CDKを使用したインフラのコード化をサポートする。 |- | AWS Terraform MCP Server || awslabs.terraform-mcp-server@latest || Terraformを使用したインフラ管理をサポートする。 |- | AWS Cloud Control API MCP Server || awslabs.aws-cloud-control-mcp-server@latest || 自然言語によるクラウドリソースの管理を提供する。 |- | Amazon ECS MCP Server || awslabs.ecs-mcp-server@latest || ECSコンテナオーケストレーションの管理を提供する。 |- | Amazon EKS MCP Server || awslabs.amazon-eks-mcp-server@latest || Kubernetes (EKS) クラスタの管理をサポートする。 |- | AWS Lambda Tool MCP Server || awslabs.lambda-tool-mcp-server@latest || Lambda関数の作成・管理・実行を提供する。 |} </center> <br> ==== AI・機械学習 ==== 下表に、AWS上のAI・機械学習サービスに関するサーバを示す。<br> <br> <center> {| class="wikitable" |+ AI・機械学習関連サーバ ! サーバ名 !! パッケージ名 !! 説明 |- | Amazon Bedrock MCP Server || awslabs.amazon-bedrock-mcp-server@latest || Foundational ModelへのアクセスとRAGを提供する。 |- | Amazon Bedrock KB Retrieval MCP Server || awslabs.bedrock-kb-retrieval-mcp-server@latest || Bedrock Knowledge Basesの検索機能を提供する。 |- | Amazon Nova Canvas MCP Server || awslabs.nova-canvas-mcp-server@latest || Amazon Nova Canvasを使用した画像生成を提供する。 |- | Amazon SageMaker MCP Server || awslabs.amazon-sagemaker-mcp-server@latest || MLモデルのトレーニングと推論環境の管理を提供する。 |} </center> <br> ==== データ・分析 ==== AWSのデータベースおよびデータ分析サービスに関するサーバを以下に示す。<br> <br> <center> {| class="wikitable" |+ データ・分析関連サーバ ! サーバ名 !! パッケージ名 !! 説明 |- | Amazon DynamoDB MCP Server || awslabs.amazon-dynamodb-mcp-server@latest || DynamoDB NoSQLデータベースの操作を提供する。 |- | Amazon RDS MCP Server || awslabs.amazon-rds-mcp-server@latest || リレーショナルデータベースの操作を提供する。 |- | Amazon Redshift MCP Server || awslabs.amazon-redshift-mcp-server@latest || データウェアハウスへのクエリ実行を提供する。 |- | Amazon Athena MCP Server || awslabs.amazon-athena-mcp-server@latest || S3上のデータに対するSQLクエリ分析を提供する。 |- | Amazon Aurora PostgreSQL MCP Server || awslabs.aurora-dsql-mcp-server@latest || Aurora PostgreSQLへの接続とクエリ実行を提供する。 |} </center> <br> ==== 開発者ツール ==== 開発・セキュリティ管理に関するサーバを以下に示す。<br> <br> <center> {| class="wikitable" |+ 開発者ツール関連サーバ ! サーバ名 !! パッケージ名 !! 説明 |- | Git Repo Research MCP Server || awslabs.git-repo-research-mcp-server@latest || Gitリポジトリの分析と情報収集を提供する。 |- | AWS IAM MCP Server || awslabs.aws-iam-mcp-server@latest || IAM権限の管理と分析を提供する。 |- | AWS Diagram MCP Server || awslabs.aws-diagram-mcp-server@latest || AWSアーキテクチャ図の自動生成を提供する。 |} </center> <br> ==== コスト・運用 ==== コスト管理と運用監視に関するサーバを以下に示す。<br> <br> <center> {| class="wikitable" |+ コスト・運用関連サーバ ! サーバ名 !! パッケージ名 !! 説明 |- | AWS Cost Explorer MCP Server || awslabs.cost-explorer-mcp-server@latest || AWSサービスのコスト分析とレポートを提供する。 |- | Amazon CloudWatch MCP Server || awslabs.amazon-cloudwatch-mcp-server@latest || ログとメトリクスの監視を提供する。 |- | AWS CloudTrail MCP Server || awslabs.aws-cloudtrail-mcp-server@latest || AWS API呼び出しのログ記録と監査を提供する。 |} </center> <br><br> == 動作要件 == ==== 共通の要件 ==== OS問わず共通して必要な要件を以下に示す。<br> <br> * uv (Astralが提供するPythonパッケージマネージャ) *: <code>uvx</code> コマンドを使用してMCPサーバを実行するために必要 * Python 3.10以上 *: MCPサーバの実行環境として必要 * AWS CLI v2 *: AWSリソースへのアクセスと認証情報の管理に必要 * AWS認証情報 (IAMユーザまたはIAM Identity Center) *: AWSサービスへのアクセス権限として必要 * AWSアカウント *: AWSサービスを利用するために必要 <br> ==== Windowsの要件 ==== * Windows 10 / 11 * <code>npx</code> を使用するMCPサーバの場合、<code>cmd /c</code> ラッパーが必要 *: <code>uvx</code> コマンドの場合はラッパー不要 <br> ==== MacOSの要件 ==== * MacOS 11.0以降を推奨 * Intel、Apple Silicon (M1 / M2 / M3 / M4) の両方に対応 <br> ==== Linuxの要件 ==== * RHEL、SUSE、Arch Linux等の主要なディストリビューションに対応 <br><br> == インストール == ==== uvのインストール ==== MCPサーバの実行に必要な <code>uv</code> をインストールする。<br> <br> ===== Windowsの場合 ===== PowerShellを使用する場合は、以下のコマンドを実行する。<br> <br> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" <br> WinGetを使用する場合は、以下のコマンドを実行する。<br> <br> winget install --id=astral-sh.uv -e <br> ===== MacOSの場合 ===== Homebrewを使用する場合は、以下のコマンドを実行する。<br> <br> brew install uv <br> curlを使用する場合は、以下のコマンドを実行する。<br> <br> curl -LsSf https://astral.sh/uv/install.sh | sh <br> ===== Linuxの場合 ===== curlを使用する場合は、以下のコマンドを実行する。<br> <br> curl -LsSf https://astral.sh/uv/install.sh | sh <br> wgetを使用する場合は、以下のコマンドを実行する。<br> <br> wget -qO- https://astral.sh/uv/install.sh | sh <br> ===== pip経由 (全OS対応) ===== pipを使用してインストールする場合は、以下のコマンドを実行する。<br> <br> pip install uv <br> ==== Pythonのインストール ==== <code>uv</code> コマンドを使用してPython 3.10以上をインストールする。<br> <br> uv python install 3.10 <br> ==== AWS CLIのインストールと認証設定 ==== AWS CLI v2のインストール後、以下のコマンドで認証情報を設定する。<br> <br> aws configure <br> SSO (IAM Identity Center) を使用する場合は、以下のコマンドを実行する。<br> <br> aws configure sso <br> 認証情報が正しく設定されているかを確認するには、以下のコマンドを実行する。<br> <br> aws sts get-caller-identity <br><br> == 設定 == ==== 設定ファイルの場所 ==== 各MCPクライアントの設定ファイルの場所は以下の通りである。<br> <br> Claude Desktopの設定ファイルを以下に示す。<br> * Linux *: <u>~/.config/Claude/claude_desktop_config.json</u> * MacOS *: <u>~/Library/Application Support/Claude/claude_desktop_config.json</u> * Windows *: <u>%APPDATA%\Claude\claude_desktop_config.json</u> <br> Claude Codeの設定ファイルを以下に示す。<br> * ローカルスコープ *: <u>.mcp.json</u> (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される * ユーザスコープ *: <u>~/.claude.json</u> (ホームディレクトリ) <br> OpenCodeの設定ファイルを以下に示す。<br> * <u>opencode.json</u> または <u>opencode.jsonc</u> (プロジェクトルート) <br> VS Codeの設定ファイルを以下に示す。<br> * <u>.vscode/mcp.json</u> (プロジェクトルート) <br> Cursorの設定ファイルを以下に示す。<br> * グローバル設定 *: <u>~/.cursor/mcp.json</u> * プロジェクト設定 *: <u>.cursor/mcp.json</u> <br> ==== ローカルMCPサーバの設定 ==== ローカルMCPサーバは、<code>uvx</code> コマンドを使用してstdio通信で実行する。<br> <br> ===== Claude Desktopでの設定 ===== <u>claude_desktop_config.json</u> に以下の内容を追記する。<br> <br> <syntaxhighlight lang="json"> { "mcpServers": { "aws-documentation": { "command": "uvx", "args": ["awslabs.aws-documentation-mcp-server@latest"], "env": { "FASTMCP_LOG_LEVEL": "ERROR" } } } } </syntaxhighlight> <br> 設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。<br> <br> ===== Claude Codeでの設定 ===== Claude Codeでは、<code>claude mcp add</code> コマンドを使用してMCPサーバを追加できる。<br> <br> 以下のコマンドでMCPサーバをClaude Codeに登録する。<br> <br> claude mcp add --transport stdio aws-documentation -- uvx awslabs.aws-documentation-mcp-server@latest <br> 環境変数を指定する場合は、<code>--env</code> オプションを追加する。<br> <br> claude mcp add --transport stdio --env FASTMCP_LOG_LEVEL=ERROR aws-documentation -- uvx awslabs.aws-documentation-mcp-server@latest <br> プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。<br> 設定は、<u>.mcp.json</u> に保存される。<br> <br> claude mcp add --transport stdio --scope project aws-documentation -- uvx awslabs.aws-documentation-mcp-server@latest <br> 上記コマンドにより生成される <u>.mcp.json</u> の内容を以下に示す。<br> <br> <syntaxhighlight lang="json"> { "mcpServers": { "aws-documentation": { "command": "uvx", "args": ["awslabs.aws-documentation-mcp-server@latest"], "env": { "FASTMCP_LOG_LEVEL": "ERROR" } } } } </syntaxhighlight> <br> ===== OpenCodeでの設定 ===== <u>opencode.json</u> の <code>mcp</code> セクションに以下に示す内容を追加する。<br> <br> <syntaxhighlight lang="json"> { "mcp": { "aws-documentation": { "command": "uvx", "args": ["awslabs.aws-documentation-mcp-server@latest"], "env": { "FASTMCP_LOG_LEVEL": "ERROR" } } } } </syntaxhighlight> <br> ===== VS Code / Cursorでの設定 ===== <u>.vscode/mcp.json</u> または <u>.cursor/mcp.json</u> に以下の内容を追加する。<br> <br> <syntaxhighlight lang="json"> { "mcpServers": { "aws-documentation": { "command": "uvx", "args": ["awslabs.aws-documentation-mcp-server@latest"], "env": { "FASTMCP_LOG_LEVEL": "ERROR" } } } } </syntaxhighlight> <br> ==== リモートMCPサーバの設定 ==== リモートMCPサーバはAWSクラウド上で実行され、HTTPプロトコルで接続する。<br> <br> ===== Claude Desktopでの設定 ===== <u>claude_desktop_config.json</u> に以下の内容を追記する。<br> <br> <syntaxhighlight lang="json"> { "mcpServers": { "aws-mcp": { "command": "uvx", "args": [ "mcp-proxy-for-aws@latest", "https://aws-mcp.us-east-1.api.aws/mcp", "--metadata", "AWS_REGION=us-west-2" ] } } } </syntaxhighlight> <br> ===== Claude Codeでの設定 ===== 以下のコマンドでリモートMCPサーバをClaude Codeに登録する。<br> <br> claude mcp add --transport http aws-mcp https://aws-mcp.us-east-1.api.aws/mcp <br> ===== VS Code / Cursorでの設定 ===== <u>.vscode/mcp.json</u> または <u>.cursor/mcp.json</u> に以下の内容を追加する。<br> <br> <syntaxhighlight lang="json"> { "mcpServers": { "aws-mcp": { "command": "uvx", "args": [ "mcp-proxy-for-aws@latest", "https://aws-mcp.us-east-1.api.aws/mcp" ] } } } </syntaxhighlight> <br> ==== Core MCP Serverの設定 ==== Core MCPサーバは、ロールベースのプロキシ戦略で複数のMCPサーバを動的に統合する。<br> 環境変数でロールを有効化することにより、対応するMCPサーバが自動的に読み込まれる。<br> <br> 利用可能なロールを以下に示す。<br> <br> <center> {| class="wikitable" |+ Core MCP Serverの利用可能なロール一覧 ! ロール名 !! 説明 |- | aws-foundation || AWSの基本知識とAPI |- | dev-tools || 開発ツール |- | ci-cd-devops || CI/CDとDevOps |- | container-orchestration || コンテナ管理 |- | serverless-architecture || サーバレス開発 |- | analytics-warehouse || データ分析・ウェアハウジング |- | data-platform-eng || データプラットフォームエンジニアリング |- | frontend-dev || フロントエンド開発 |- | solutions-architect || ソリューションアーキテクチャ |- | finops || 財務運用 (FinOps) |- | monitoring-observability || 監視・可観測性 |- | caching-performance || キャッシング・パフォーマンス最適化 |- | security-identity || セキュリティ・アイデンティティ管理 |- | sql-db-specialist || SQLデータベース |- | nosql-db-specialist || NoSQLデータベース |- | timeseries-db-specialist || 時系列データベース |- | messaging-events || メッセージング・イベント処理 |- | healthcare-lifesci || ヘルスケア・ライフサイエンス |} </center> <br> 以下に、<code>solutions-architect</code> と <code>finops</code> ロールを有効化する設定例を示す。<br> <br> <syntaxhighlight lang="json"> { "mcpServers": { "awslabs.core-mcp-server": { "command": "uvx", "args": ["awslabs.core-mcp-server@latest"], "env": { "FASTMCP_LOG_LEVEL": "ERROR", "solutions-architect": "true", "finops": "true" } } } } </syntaxhighlight> <br> ==== Windowsでの設定の注意点 ==== Windowsでは、使用するコマンドの種類によって設定方法が異なる。<br> <br> <code>npx</code> を使用するMCPサーバの場合は、<code>cmd /c</code> ラッパーが必須である。<br> <br> <syntaxhighlight lang="json"> { "mcpServers": { "my-server": { "command": "cmd", "args": ["/c", "npx", "-y", "package-name"] } } } </syntaxhighlight> <br> <code>uvx</code> を使用するMCPサーバの場合は、ラッパーは不要である。<br> <br> <syntaxhighlight lang="json"> { "mcpServers": { "aws-documentation": { "command": "uvx", "args": ["awslabs.aws-documentation-mcp-server@latest"] } } } </syntaxhighlight> <br><br> == 使用方法 == MCPサーバを設定後、AIアシスタントに自然言語で指示するだけで、対応するツールが自動的に呼び出される。<br> <br> ==== AWS Documentation MCPサーバの使用例 ==== AWS公式ドキュメントへのアクセスや情報検索に関する操作例を以下に示す。<br> <br> * S3バケットの暗号化設定を調べる場合 *: <syntaxhighlight lang="text"> # プロンプト例 : S3バケットの暗号化について、AWS公式ドキュメントから情報を取得してください。 </syntaxhighlight> *: <br> * Lambda関数のベストプラクティスを検索する場合 *: <syntaxhighlight lang="text"> # プロンプト例 : Lambda関数のタイムアウト設定について、ベストプラクティスを検索してください。 </syntaxhighlight> *: <br> * EC2インスタンスタイプを比較する場合 *: <syntaxhighlight lang="text"> # プロンプト例 : EC2インスタンスタイプの比較表を作成してください。 </syntaxhighlight> <br> ==== Core MCPサーバの使用例 ==== 複数のMCPサーバを統合して活用する操作例を以下に示す。<br> <br> * CloudFormationとコスト最適化を組み合わせる場合 *: <syntaxhighlight lang="text"> # プロンプト例 : デプロイメント用のCloudFormationテンプレートを作成して、インフラコストを最適化する方法を提案してください。 </syntaxhighlight> *: <br> * VPCのセキュリティ設定を確認する場合 *: <syntaxhighlight lang="text"> # プロンプト例 : VPCネットワークのセキュリティグループ設定を確認してください。 </syntaxhighlight> <br> ==== AWS IaC MCPサーバの使用例 ==== インフラストラクチャのコード化に関する操作例を以下に示す。<br> <br> * CDKを使用してS3バケットを作成する場合 *: <syntaxhighlight lang="text"> # プロンプト例 : CDKでS3バケットを暗号化有効で作成する方法を教えてください。 </syntaxhighlight> *: <br> * CloudFormationテンプレートを検証する場合 *: <syntaxhighlight lang="text"> # プロンプト例 : CloudFormationテンプレートを検証してセキュリティチェックを実行してください。 </syntaxhighlight> <br><br> == トラブルシューティング == ==== 共通の問題 ==== 下表に、OS問わず発生する可能性がある問題と対処法を示す。<br> <br> <center> {| class="wikitable" |+ 共通トラブルシューティング ! 問題 !! 対処法 |- | <u>uv: command not found</u> || PATHの設定を確認する。<br>シェルの設定ファイル (<u>~/.bashrc</u> 等) を再読み込み、または、uvを再インストールする。 |- | タイムアウトエラーが発生する || MCPクライアントの設定でタイムアウト値を増加させる。 |- | <u>AccessDenied</u> / <u>UnauthorizedException</u> が発生する || AWS認証情報の有効期限を確認する。<br><code>aws sts get-caller-identity</code> コマンドで認証状態を確認し、<br>IAMポリシーに必要な権限が付与されているか確認する。 |- | <u>Token has expired</u> エラーが発生する || <code>aws sso login</code> または <code>aws configure sso</code> コマンドを再実行して、<br>認証トークンを更新する。 |- | Connection closedエラーが発生する (Windows) || npxを使用するサーバの場合、<code>cmd /c</code> ラッパーを設定ファイルに追加する。 |- | サーバが起動しない || MCPクライアントを再起動する。<br>ログファイルを確認してエラーの詳細を調べる。 |} </center> <br> ==== Windowsでの問題 ==== 下表に、Windows環境で発生する可能性がある問題と対処法を示す。<br> <br> <center> {| class="wikitable" |+ Windowsのトラブルシューティング ! 問題 !! 対処法 |- | ENOENTエラーが発生する || 設定ファイルに環境変数 (<code>PATH</code> 等) を明示的に指定する。 |- | npxが見つからない || <code>npm install -g npm</code> コマンドを実行して、npmを最新バージョンに更新する。 |} </center> <br> ==== MacOSでの問題 ==== 下表に、MacOS環境で発生する可能性がある問題と対処法を示す。<br> <br> <center> {| class="wikitable" |+ MacOSのトラブルシューティング ! 問題 !! 対処法 |- | Apple Silicon環境で、uvコマンドが見つからない || Homebrewを使用して、uvを再インストールする。<br><code>brew install uv</code> コマンドを実行する。 |} </center> <br> ==== Linuxでの問題 ==== 下表に、Linux環境で発生する可能性がある問題と対処法を示す。<br> <br> <center> {| class="wikitable" |+ Linuxのトラブルシューティング ! 問題 !! 対処法 |- | uvコマンドが見つからない || ~/.profileファイル等に環境変数 <code>PATH</code> が正しく設定されているか確認する。 |- | パーミッションエラーが発生する || 実行権限を付与する。<br>例: <code>chmod +x ~/.local/bin/uv</code> |} </center> <br><br> {{#seo: |title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki |keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,AWS,Amazon Web Services,MCP,Model Context Protocol,Claude,Claude Code,Claude Desktop,OpenCode,VS Code,Cursor,Windsurf,Kiro,awslabs,uv,uvx,Bedrock,CDK,CloudFormation,Terraform,Lambda,ECS,EKS,DynamoDB,RDS,Redshift,Athena,SageMaker,IAM,CloudWatch,CloudTrail,MCPサーバ,AIアシスタント |description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux |image=/resources/assets/MochiuLogo_Single_Blue.png }} __FORCETOC__ [[カテゴリ:設定]]
MCPサーバ - AWS
に戻る。
案内
メインページ
最近の更新
おまかせ表示
MediaWiki についてのヘルプ
ツール
リンク元
関連ページの更新状況
特別ページ
ページ情報
We ask for
Donations
Collapse