6.3K Views
April 30, 25
スライド概要
2025年4月30日に開催した社内イベント「AWSランチセッション第5回」の発表資料です。
AWS上に構築した社内向け動画ストリーミング研修システムのPoCに対して、ClineとAWS MCP Serversを使ってレビューと機能追加を行う内容になります。
実際にレビュー作業と機能追加作業を行った際の動画を以下で公開しています。ぜひ合わせてご覧ください。
動画「ClineとAWS MCP Serversを使用したシステムレビュー」
https://www.docswell.com/s/kkmtyyz/vKN89ZJ-2025-04-30-9330
動画「ClineでAWSシステムの追加機能を開発」
https://www.docswell.com/s/kkmtyyz/vP5WGMJ-2025-04-30-9900
SFとコンピュータが好き
2025-04-30 AWSランチセッション 第5回 AIコーディングエージェントClineとAWS MCP Serversで AWSを使ったシステムのレビューと機能追加してみた 山崎 拓也
山崎 拓也 所属: SIer 仕事: • システム開発など • アプリとAWSインフラ両方 好き: 低レイヤ、SF、AWS AWS関連: • 2024 Japan AWS Top Engineer • 2022~2024 Japan AWS All Certifications Engineer
アジェンダ • ClineとAWS MCP Serversについて • システムレビュータスク • システム機能追加タスク • まとめ
ClineとAWS MCP Serversについて
Clineとは • Visual Studio Codeと統合されたAIコーディングエージェント • 複雑なソフトウェア開発タスクを段階的に処理する • プロジェクト探索、ファイル作成・編集、内部ブラウザの使用、コマンド やツールの実行などが可能
2つのモード:Plan & Act • Planモードでタスクについて計画し、Actモードで実行する • 「コメントからTabでコード補完」「コードをいきなり全て書かせる」ではなく、 タスク実行に必要な調査や、開発の方向性などを計画してから、実際に開発を行う • モード間はコンテキストを保ったまま行き来できる • 体験がとても良いので個人的にすごく好きな特徴 Planモード • コードを書かない • コンテキスト収集と戦略に最適化 • 要件理解と実装計画の作成 • 質問してくれる Actモード • 計画に基づいてコードを書く
その他の特徴 • 様々なモデルが使用できる • 料金やコンテキスト長が常に表示される • MCPにも対応
MCPとは(Model Context Protocol) • モデルにコンテキストを提供するプロトコル • モデルが様々なデータソースやツールに接続できるようになる • ToolUseのイメージに近い • ツールの作成・利用が標準化されて便利になった • ツールの説明を書かなくて良くなった点が嬉しい • (昨日4/29からAmazon Q Developer CLIもMCPに対応!) https://modelcontextprotocol.io/introduction
AWS MCP ServersはAWSの公式MCPサーバー • Core MCP Server • 他のAWS MCPサーバーを管理調整する • AWS MCPサーバーを使うときはこのサーバーを最初に実行するよう指示すると良い • AWS Documentation MCP Server • 公式ドキュメントやベストプラクティスを検索・取得できる • AWS CDK MCP Server • CDKプロジェクトの分析やベストプラクティスの取得 • Cost Analysis MCP Server • AWSコストの分析 • などなど https://github.com/awslabs/mcp
(補足)MCPサーバーのインストール • 手動でもインストールもできるが、ClineのMarketplaceからもインストー ルできる • インストール作業がClineによって思考しながら行われる点が面白い
今回レビューと機能追加を行う、社内向け動画研修システム https://kkmtyyz.hatenablog.com/entry/2024/11/14/030341
CDKを使用しており、動画ストリーミング機能や、動画変換機能を持つ AWS Elemental MediaConvert mp4 → HLS
プロジェクト固有のコンテキストは「.clinerules」ファイルに記述する • タスク実行時に内容を加味してくれる • Clineに作ってもらうのが楽 <プロンプト> このプロジェクトの.clinerulesファイルを作りたいです。 次のurlを参照してください。 @https://github.com/cline/cline/blob/main/docs%2Fprompting%2FREADME.md • 非機能要件なども伝えて追記してもらう <プロンプト> ユーザー数は200名程度で、予想される利用頻度は各ユーザーごとに月2回くらい。 あと社内向けサービスだからユーザーからのアクセスは必ずVPNを使うようにして、 インターネットとの通信を最小限にする必要がある。 とりあえずcognitoだけは、VPCエンドポイントが提供されていないから、 インターネットへのアクセスを許可してる。
(補足)「.clinerules」が読み込まれない場合 • Settings の Custom Instructionsに読み込むよう指示を記述すると改善す る
システムレビュータスク
MCPサーバーを使いつつシステムのレビューをしてもらう <プロンプト> このプロジェクトをAWSのベストプラクティスに従ってレビューしてください。 適宜MCPサーバーも使ってください。 AWSのMCPサーバーを使用する場合はCore MCP Serverを最初に使ってください。 レビュー結果はW-Aの柱に沿って良い点と改善点を優先度の高い順に各2つずつ示してくだ さい。 • レビュー時の動画を見ながら解説します (次ページからは動画の要点の抜粋になります) 動画は以下で公開しています 「ClineとAWS MCP Serversを使用したシステムレビュー」 https://www.docswell.com/s/kkmtyyz/vKN89ZJ-2025-04-30-9330
アクションが必要な時はユーザーに許可を求める ファイル読み込み許可を求める
アクションの自動承認設定が可能 プロジェクトファイルの読み込みのみ許可
はじめに、レビューに必要なファイルを全て読むため大きなプロジェクトだと大変 ファイルを次々解析していく CDK関連だけでなく、フロントエンドや バックエンドのコードなども解析する
ファイル解析完了後、AWS Core MCP Serverを呼び出す MCPサーバーの使用許可を求める
その後も必要に応じて各種MCPサーバーを使用しつつレビューが進んでいく
最後にレビュー結果をまとめてくれる
レビュー結果をHTMLでスライド1枚にまとめてもらう <プロンプト> プレゼン用にレビュー結果を端的にまとめ、1枚のスライドとしてHTMLで出力してくださ い。 スライドは横長の16:9で、タイトルは不要です。 その後、内部ブラウザで表示してください。 チャットの中にブラウザ の画面が表示される
レビュー結果の抜粋(1/2)
レビュー結果の抜粋(2/2)
プロジェクトレビュータスクに関するまとめ • レビュー結果は結構参考になる • どのMCPサーバーを呼ぶ呼ばないはエージェント任せになる • 必要そうなファイルを全て読むので大きなプロジェクトだと時間とコンテ キスト長がかかりそう • cdk-nagのツールがルールごとに実行されるので、あらかじめcdk-nagの 実行結果を用意しておくと良いかも MCPサーバーの使用回数 15回 Core Server 1回 AWS CDK Assistant 4回 Cost Analysis 1回 AWS Documentation 8回 AWS Diagrams 1回(複雑すぎて失敗) かかった時間 18分 かかった料金 1.9ドル
システム機能追加タスク
Clineで動画視聴ページにユーザーからのレビュー機能を作る 作業前 動画と概要のみ 完成後 動画の下にレビュー投稿と一覧
Planモードで実行 <プロンプト> 新しく研修動画のレビュー機能を加えようと思う。 動画再生ページでレビューの作成と表示ができればいいです。 アーキテクチャは大きく変えずに、AWS Core MCP Serverを使ってベストプラクティスに 沿った形で実現したい。 • 機能追加時の動画を見ながら解説します (次ページからは動画の要点の抜粋になります) 動画は以下で公開しています 「ClineでAWSシステムの追加機能を開発」 https://www.docswell.com/s/kkmtyyz/vP5WGMJ-2025-04-30-9900
まずはタスクに関係しそうなファイルを解析していく
Core MCP Serverを実行後、実装計画を提案してくれる
実装計画から抜粋
提案された実装計画に指摘や要望を行いつつ計画を詰めていく
実装計画が完成したら、Actモードに切り替えて実装してもらう
計画に従って1ファイルずつ修正されるため、実装を確認しながら進められる コードをじっくり確認しつつ、 いつでもここから指摘や確認ができる
問題のある実装や、不適切な実装を見つけ、指摘する必要がある
実装計画が無事最後まで終わると完了
デプロイ後、不具合のためコードを1行だけ手で追加
システム機能追加タスクに関するまとめ • Plan&Actで一緒に開発していくのは効率が良く、楽しい • 実装を隅々まで確認するのはやや疲れる。非推奨なメソッドを見落とした りする • テストの実行もできるので、ローカルでのテストをきちんと書いていれば 動くものは出来上がりそう MCPサーバーの使用回数 1回 Core Server 1回 Planでの指摘や相談回数 4回 Actでの指摘回数 1回 かかった時間 25分 かかった料金 0.6ドル
まとめ • AWS MCP Serversはシステムレビューにもとても有用 • ClineはPlan&Actにより効率よく、楽しく開発が行える • 人間にはAIエージェントを導くことができるスキルが必要 • レビューや提案から誤りを見つけ、指摘する力 • その時は問題にならないが、未来に向けてより良い設計や実装をする力 「強くて優れた武器を扱うからこそ、 その使い手はより強くタフでなければならない」 TVアニメ「PSYCHO-PASS サイコパス」より引用* *https://psycho-pass.com/archive/character/
(補足).clinerulesとCost Analysis MCPサーバーでざっくりコスト見積もりもできる (1/2)
(補足).clinerulesとCost Analysis MCPサーバーでざっくりコスト見積もりもできる (2/2)
ご清聴ありがとうございました。