Skip to content

Latest commit

 

History

History
250 lines (183 loc) · 20.8 KB

File metadata and controls

250 lines (183 loc) · 20.8 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

これらのリソースを使い始めるには、以下の手順に従ってください:

  1. リポジトリをフォークする: クリック GitHub forks
  2. リポジトリをクローンする: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Azure AI Foundry Discordに参加して、専門家や開発者仲間と交流しましょう

🌐 多言語対応

GitHub Actionによるサポート(自動化&常に最新)

French | Spanish | German | Russian | Arabic | Persian (Farsi) | Urdu | Chinese (Simplified) | Chinese (Traditional, Macau) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Taiwan) | Japanese | Korean | Hindi | Bengali | Marathi | Nepali | Punjabi (Gurmukhi) | Portuguese (Portugal) | Portuguese (Brazil) | Italian | Polish | Turkish | Greek | Thai | Swedish | Danish | Norwegian | Finnish | Dutch | Hebrew | Vietnamese | Indonesian | Malay | Tagalog (Filipino) | Swahili | Hungarian | Czech | Slovak | Romanian | Bulgarian | Serbian (Cyrillic) | Croatian | Slovenian | Ukrainian | Burmese (Myanmar)

🚀 Model Context Protocol (MCP) 初心者向けカリキュラム

C#, Java, JavaScript, Python, TypeScriptで学ぶMCPの実践コード例

🧠 Model Context Protocolカリキュラムの概要

Model Context Protocol (MCP) は、AIモデルとクライアントアプリケーション間のやり取りを標準化するために設計された最先端のフレームワークです。このオープンソースのカリキュラムは、C#, Java, JavaScript, TypeScript, Pythonなどの人気プログラミング言語での実践的なコード例や実際のユースケースを含む、体系的な学習パスを提供します。

AI開発者、システムアーキテクト、ソフトウェアエンジニアのいずれであっても、このガイドはMCPの基本と実装戦略をマスターするための包括的なリソースです。

🔗 公式MCPリソース

2025年7月29-30日 MCP Dev Daysに参加しよう

MCP Dev Daysは、AIモデルとそれを支えるツールをつなぐ新しい標準であるModel Context Protocol (MCP)に特化したバーチャルイベントです。2日間にわたり、深い技術的洞察、コミュニティとの交流、実践的な学びを提供します。

➡️ MCP Dev Daysに登録する

MCP Dev Daysはイベントページ https://aka.ms/mcpdevdays で登録すると視聴可能です。YouTubeやTwitchでのライブ配信に参加でき、すべてのコンテンツは録画され、後日Microsoft DeveloperのYouTubeチャンネルで視聴可能です。デモのソースコードもGitHubで公開されます。

イベント詳細

  • 日程:7月29日(1日目)&7月30日(2日目)
  • 時間:毎日午前9時(PST)
  • 場所:オンライン - どこからでも参加可能!

1日目:MCPの生産性、開発ツール、コミュニティ

開発者がMCPを開発ワークフローに活用できるよう支援し、素晴らしいMCPコミュニティを祝います。Arcade、Block、Okta、Neonなどのコミュニティメンバーやパートナーと共に、Microsoftと協力してオープンで拡張可能なMCPエコシステムを形作る様子を紹介。VS Code、Visual Studio、GitHub Copilot、人気のコミュニティツールを使った実践的なデモや、コンテキストに基づく開発ワークフロー、コミュニティ主導のセッションや洞察もあります。MCPを始めたばかりの方も、すでに使っている方も、1日目はインスピレーションと実践的なヒントが満載です。

2日目:自信を持ってMCPサーバーを構築しよう

MCPの構築者向けに、MCPサーバーの実装戦略やベストプラクティス、AIワークフローへの統合方法を深掘りします。

トピック例:

  • MCPサーバーの構築とエージェント体験への統合
  • プロンプト駆動開発
  • セキュリティのベストプラクティス
  • Functions、ACA、API Managementなどのビルディングブロックの活用
  • レジストリの整合性とツール(1P + 3P)

開発者、ツールビルダー、AIプロダクト戦略担当者にとって、スケーラブルで安全、かつ将来に備えたMCPソリューションを構築するための貴重な知見が詰まった1日です。

🧭 MCPカリキュラム概要

📚 完全なカリキュラム構成

モジュール トピック 説明 リンク
モジュール 1-3: 基礎
00 MCP入門 Model Context Protocolの概要とAIパイプラインにおける重要性 続きを読む
01 コアコンセプトの解説 MCPの基本概念を詳しく解説 続きを読む
02 MCPのセキュリティ セキュリティ脅威とベストプラクティス 続きを読む
03 MCPの始め方 環境設定、基本的なサーバー/クライアント、統合方法 続きを読む
モジュール 3: 最初のサーバー&クライアント構築
3.1 最初のサーバー 最初のMCPサーバーを作成する ガイド
3.2 最初のクライアント 基本的なMCPクライアントを開発する ガイド
3.3 LLMを使ったクライアント 大規模言語モデルを統合する ガイド
3.4 VS Code統合 VS CodeでMCPサーバーを利用する ガイド
3.5 SSEサーバー Server-Sent Eventsを使ったサーバーを作成する ガイド
3.6 HTTPストリーミング MCPでHTTPストリーミングを実装する ガイド
3.7 AIツールキット MCPでAIツールキットを使う ガイド
3.8 テスト MCPサーバーの実装をテストする ガイド
3.9 デプロイ MCPサーバーを本番環境にデプロイする ガイド
モジュール 4-5: 実践&応用
04 実践的な実装 SDK、デバッグ、テスト、再利用可能なプロンプトテンプレート 続きを読む
05 MCPの高度なトピック マルチモーダルAI、スケーリング、エンタープライズ利用 続きを読む
5.1 Azure統合 AzureとのMCP統合 ガイド
5.2 マルチモダリティ 複数のモダリティを扱う ガイド
5.3 OAuth2デモ OAuth2認証を実装する ガイド
5.4 ルートコンテキスト ルートコンテキストの理解と実装 ガイド
5.5 ルーティング MCPのルーティング戦略 ガイド
5.6 サンプリング MCPにおけるサンプリング手法 ガイド
5.7 スケーリング MCP実装のスケーリング ガイド
5.8 セキュリティ 高度なセキュリティ考慮事項 ガイド
5.9 ウェブ検索 ウェブ検索機能の実装 ガイド
5.10 リアルタイムストリーミング リアルタイムストリーミング機能の構築 ガイド
5.11 リアルタイム検索 リアルタイム検索の実装 ガイド
5.12 Entra ID 認証 Microsoft Entra ID を使った認証 ガイド
5.13 Foundry 統合 Azure AI Foundry との統合 ガイド
5.14 コンテキストエンジニアリング 効果的なコンテキストエンジニアリングの手法 ガイド
モジュール 6-10: コミュニティとベストプラクティス
06 コミュニティ貢献 MCP エコシステムへの貢献方法 ガイド
07 早期導入からの洞察 実際の導入事例 ガイド
08 MCP のベストプラクティス パフォーマンス、フォールトトレランス、レジリエンス ガイド
09 MCP ケーススタディ 実践的な実装例 ガイド
10 ハンズオンワークショップ AI ツールキットを使った MCP サーバー構築 ラボ

💻 サンプルコードプロジェクト

基本的な MCP 電卓サンプル

言語 説明 リンク
C# MCP サーバーの例 コードを見る
Java MCP 電卓 コードを見る
JavaScript MCP デモ コードを見る
Python MCP サーバー コードを見る
TypeScript MCP の例 コードを見る

高度な MCP 実装

言語 説明 リンク
C# 高度なサンプル コードを見る
Java コンテナアプリの例 コードを見る
JavaScript 高度なサンプル コードを見る
Python 複雑な実装 コードを見る
TypeScript コンテナサンプル コードを見る

🎯 MCP 学習の前提条件

このカリキュラムを最大限に活用するために、以下の知識があると良いでしょう:

  • C#, Java, JavaScript, Python, または TypeScript のいずれかの基本的なプログラミング知識

  • クライアント・サーバーモデルと API の理解

  • REST や HTTP の基本概念の理解

  • (任意)AI/ML の基礎知識

  • コミュニティディスカッションへの参加によるサポート

📚 学習ガイドとリソース

このリポジトリには、効果的に学習を進めるためのさまざまなリソースが含まれています:

学習ガイド

包括的な学習ガイドが用意されており、リポジトリの活用をサポートします。内容は以下の通りです:

  • すべてのトピックを示したビジュアルカリキュラムマップ
  • 各セクションの詳細な内訳
  • サンプルプロジェクトの使い方の案内
  • スキルレベル別の推奨学習パス
  • 学習を補完する追加リソース

変更履歴

カリキュラム資料の重要な更新を追跡する詳細な変更履歴を管理しています。内容は以下を含みます:

  • 新規コンテンツの追加
  • 構造の変更
  • 機能改善
  • ドキュメントの更新

🛠️ このカリキュラムを効果的に使うには

各レッスンには以下が含まれます:

  1. MCP の概念をわかりやすく解説
  2. 複数言語でのライブコード例
  3. 実際に MCP アプリケーションを作る演習
  4. 上級者向けの追加リソース

🌟 コミュニティへの感謝

Microsoft Valued Professional の Shivam Goyal に重要なコードサンプルの提供で感謝します。

📜 ライセンス情報

このコンテンツは MIT ライセンス の下で提供されています。利用条件については LICENSE をご覧ください。

🤝 貢献ガイドライン

このプロジェクトは貢献や提案を歓迎します。ほとんどの貢献には、貢献物の使用権を当方に付与することを宣言する Contributor License Agreement (CLA) への同意が必要です。詳細は
https://cla.opensource.microsoft.com をご覧ください。

プルリクエストを送ると、CLA ボットが自動的に CLA の提出が必要か判定し、PR に適切な表示(ステータスチェックやコメント)を行います。ボットの指示に従ってください。CLA は当方のすべてのリポジトリで一度だけ提出すれば済みます。

このプロジェクトは Microsoft Open Source Code of Conduct を採用しています。詳細は Code of Conduct FAQ をご覧いただくか、質問があれば opencode@microsoft.com までご連絡ください。

📂 リポジトリ構成

リポジトリは以下のように構成されています:

  • Core Curriculum (00-10): 10の連続モジュールで構成されたメインコンテンツ
  • images/: カリキュラム全体で使用される図やイラスト
  • translations/: 多言語対応の自動翻訳ファイル
  • translated_images/: ローカライズされた図やイラスト
  • study_guide.md: リポジトリの活用を支援する包括的ガイド
  • changelog.md: カリキュラム資料の重要な変更履歴
  • mcp.json: MCP 仕様の設定ファイル
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: プロジェクト運営に関するドキュメント

🎒 その他のコース

当チームでは他にもコースを提供しています。ぜひご覧ください:

™️ 商標に関する注意

このプロジェクトには、プロジェクト名、製品名、サービス名の商標やロゴが含まれている場合があります。Microsoft の商標やロゴの使用は、Microsoft の商標およびブランドガイドライン に従う必要があります。
Microsoft の商標やロゴを改変したバージョンで使用する場合は、混乱を招いたり Microsoft の後援を示唆したりしないようにしてください。
第三者の商標やロゴの使用は、それぞれの第三者のポリシーに従います。

免責事項
本書類はAI翻訳サービス「Co-op Translator」を使用して翻訳されました。正確性を期しておりますが、自動翻訳には誤りや不正確な部分が含まれる可能性があります。原文の言語による文書が正式な情報源とみなされるべきです。重要な情報については、専門の人間による翻訳を推奨します。本翻訳の利用により生じた誤解や誤訳について、当方は一切の責任を負いかねます。