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によるサポート (自動化 & 常に最新)

アラビア語 | ベンガル語 | ブルガリア語 | ビルマ語 (ミャンマー) | 中国語 (簡体字) | 中国語 (繁体字, 香港) | 中国語 (繁体字, マカオ) | 中国語 (繁体字, 台湾) | クロアチア語 | チェコ語 | デンマーク語 | オランダ語 | フィンランド語 | フランス語 | ドイツ語 | ギリシャ語 | ヘブライ語 | ヒンディー語 | ハンガリー語 | インドネシア語 | イタリア語 | 日本語 | 韓国語 | マレー語 | マラーティー語 | ネパール語 | ノルウェー語 | ペルシャ語 (ファルシー) | ポーランド語 | ポルトガル語 (ブラジル) | ポルトガル語 (ポルトガル) | パンジャブ語 (グルムキー) | ルーマニア語 | ロシア語 | セルビア語 (キリル文字) | スロバキア語 | スロベニア語 | スペイン語 | スワヒリ語 | スウェーデン語 | タガログ語 (フィリピン) | タイ語 | トルコ語 | ウクライナ語 | ウルドゥー語 | ベトナム語

🚀 モデルコンテキストプロトコル (MCP) 初心者向けカリキュラム

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

🧠 モデルコンテキストプロトコルカリキュラムの概要

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

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

🔗 MCP公式リソース

🧭 MCPカリキュラム概要

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

モジュールトピック説明リンク
モジュール1-3: 基礎
00MCPの紹介モデルコンテキストプロトコルの概要とAIパイプラインにおける重要性詳細はこちら
01コアコンセプトの解説MCPのコアコンセプトを深く掘り下げる詳細はこちら
02MCPのセキュリティセキュリティ脅威とベストプラクティス詳細はこちら
03MCPの始め方環境設定、基本的なサーバー/クライアント、統合詳細はこちら
モジュール3: 初めてのサーバーとクライアントの構築
3.1初めてのサーバーMCPサーバーを初めて作成するガイド
3.2初めてのクライアント基本的なMCPクライアントを開発するガイド
3.3LLMを使ったクライアント大規模言語モデルを統合するガイド
3.4VS Code統合VS CodeでMCPサーバーを利用するガイド
3.5stdioサーバーstdioトランスポートを使用してサーバーを作成するガイド
3.6HTTPストリーミングMCPでHTTPストリーミングを実装するガイド
3.7AIツールキットMCPでAIツールキットを使用するガイド
3.8テストMCPサーバーの実装をテストするガイド
3.9デプロイメントMCPサーバーを本番環境にデプロイするガイド
3.10高度なサーバー使用高度な機能を使用するためのサーバーと改善されたアーキテクチャガイド
3.11シンプルな認証認証の基本とRBACを示す章ガイド
モジュール4-5: 実践 & 高度な内容
04実践的な実装SDK、デバッグ、テスト、再利用可能なプロンプトテンプレート詳細はこちら
05MCPの高度なトピックマルチモーダルAI、スケーリング、エンタープライズ利用詳細はこちら
5.1Azure統合MCPとAzureの統合ガイド
5.2マルチモーダリティ複数のモーダリティを扱うガイド
5.3OAuth2デモOAuth2認証を実装するガイド
5.4ルートコンテキストルートコンテキストを理解し実装するガイド
5.5ルーティングMCPのルーティング戦略ガイド
5.6サンプリングMCPでのサンプリング技術ガイド
5.7スケーリングMCPの実装をスケールするガイド
5.8セキュリティ高度なセキュリティ考慮事項ガイド
5.9ウェブ検索ウェブ検索機能を実装するガイド
5.10リアルタイムストリーミングリアルタイムストリーミング機能を構築するガイド
5.11リアルタイム検索リアルタイム検索を実装するガイド
5.12Entra ID認証Microsoft Entra IDで認証するガイド
5.13Foundry統合Azure AI Foundryと統合するガイド
5.14コンテキストエンジニアリング効果的なコンテキストエンジニアリングの技術ガイド
5.15MCPカスタムトランスポートカスタムトランスポートの実装ガイド
モジュール6-10: コミュニティ & ベストプラクティス
06コミュニティ貢献MCPエコシステムへの貢献方法ガイド
07初期採用からの洞察実際の実装事例ガイド
08MCPのベストプラクティスパフォーマンス、フォールトトレランス、回復力ガイド
09MCPケーススタディ実践的な実装例ガイド
10実践ワークショップAIツールキットを使ったMCPサーバーの構築ラボ
モジュール11: MCPサーバー実践ラボ
11MCPサーバーデータベース統合PostgreSQL統合のための包括的な13ラボ学習パスラボ
11.1はじめにMCPとデータベース統合および小売分析ユースケースの概要ラボ00
11.2コアアーキテクチャMCPサーバーのアーキテクチャ、データベース層、セキュリティパターンの理解Lab 01
11.3セキュリティとマルチテナンシー行レベルセキュリティ、認証、マルチテナントデータアクセスLab 02
11.4環境設定開発環境のセットアップ、Docker、AzureリソースLab 03
11.5データベース設計PostgreSQLのセットアップ、小売スキーマ設計、サンプルデータLab 04
11.6MCPサーバーの実装データベース統合を備えたFastMCPサーバーの構築Lab 05
11.7ツール開発データベースクエリツールとスキーマインスペクションの作成Lab 06
11.8セマンティック検索Azure OpenAIとpgvectorを使用したベクトル埋め込みの実装Lab 07
11.9テストとデバッグテスト戦略、デバッグツール、検証アプローチLab 08
11.10VS Code統合VS Code MCP統合とAIチャットの使用方法の設定Lab 09
11.11デプロイメント戦略Dockerデプロイメント、Azure Container Apps、スケーリングの考慮事項Lab 10
11.12モニタリングApplication Insights、ログ、パフォーマンスモニタリングLab 11
11.13ベストプラクティスパフォーマンス最適化、セキュリティ強化、運用のヒントLab 12

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

基本的なMCP計算機サンプル

言語説明リンク
C#MCPサーバー例コードを見る
JavaMCP計算機コードを見る
JavaScriptMCPデモコードを見る
PythonMCPサーバーコードを見る
TypeScriptMCP例コードを見る
RustMCP例コードを見る

高度なMCP実装

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

🎯 MCP学習の前提条件

このカリキュラムを最大限活用するために、以下の知識が必要です:

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

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

  • RESTとHTTPの概念に関する知識

  • (オプション)AI/MLの概念に関する背景知識

  • サポートのためにコミュニティディスカッションに参加すること

📚 学習ガイドとリソース

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

学習ガイド

包括的な学習ガイドが利用可能で、このリポジトリを効果的に活用する方法を案内します。ガイドには以下が含まれます:

  • カバーされるすべてのトピックを示すビジュアルカリキュラムマップ
  • 各リポジトリセクションの詳細な内訳
  • サンプルプロジェクトの使用方法に関するガイダンス
  • スキルレベルに応じた推奨学習パス
  • 学習を補完する追加リソース

変更履歴

カリキュラム資料のすべての重要な更新を追跡する詳細な変更履歴を維持しています:

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

🛠️ このカリキュラムを効果的に活用する方法

このガイドの各レッスンには以下が含まれます:

  1. MCPの概念に関する明確な説明
  2. 複数の言語でのライブコード例
  3. 実際のMCPアプリケーションを構築するための演習
  4. 上級学習者向けの追加リソース

イベント

MCP Dev Days 2025年7月

➡️オンデマンド視聴 - MCP Dev Days

MCP Dev Daysは、AIモデルとそれを支えるツールをつなぐ新しい標準であるModel Context Protocol (MCP)に特化したバーチャルイベントです。2日間にわたる技術的な洞察、コミュニティとのつながり、実践的な学習をお楽しみください。 イベントページで登録してMCP Dev Daysを視聴できます: https://aka.ms/mcpdevdays.

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ソリューションを構築するための洞察が詰まった日です。

MCPブートキャンプ 2025年8月

MCPサーバーを作成し、VS Codeと統合し、Azureでプロフェッショナルにデプロイする方法を学ぶ集中ビデオセッション。初心者向けカリキュラムに基づいて実践的なスキルを習得できます。

➡️オンデマンド視聴 MCPブートキャンプ | 英語

➡️オンデマンド視聴 MCPブートキャンプ | ブラジル

➡️オンデマンド視聴 MCPブートキャンプ | スペイン語

C#で学ぶMCP - チュートリアルシリーズ

Model Context Protocol (MCP)について学びましょう。これはAIモデルとクライアントアプリケーション間のやり取りを標準化するために設計された最先端のフレームワークです。この初心者向けセッションでは、MCPを紹介し、最初のMCPサーバーを作成する方法を案内します。

C#: https://aka.ms/letslearnmcp-csharp

Java: https://aka.ms/letslearnmcp-java

JavaScript: https://aka.ms/letslearnmcp-javascript

Python: https://aka.ms/letslearnmcp-python

🌟 コミュニティへの感謝

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

📜 ライセンス情報

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

🤝 貢献ガイドライン

このプロジェクトは貢献と提案を歓迎します。ほとんどの貢献には、貢献者ライセンス契約(CLA)に同意する必要があります。これにより、貢献を使用する権利を私たちに与えることを宣言します。詳細はhttps://cla.opensource.microsoft.comをご覧ください。

プルリクエストを送信すると、CLAボットが自動的にCLAが必要かどうかを判断し、PRに適切な装飾を施します(例:ステータスチェック、コメント)。ボットの指示に従うだけで済みます。CLAはすべてのリポジトリで一度だけ提供すれば済みます。

このプロジェクトはMicrosoft Open Source Code of Conductを採用しています。 詳細についてはCode of Conduct FAQをご覧いただくか、opencode@microsoft.comまでお問い合わせください。

📂 リポジトリ構造

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

  • コアカリキュラム (00-11): 11の連続モジュールに整理された主要コンテンツで、包括的なデータベース統合ラボを含む
  • 11-MCPServerHandsOnLabs/: PostgreSQL統合を備えた実運用対応のMCPサーバーを構築するための13ラボ学習パス
  • 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アプリの構築で行き詰まったり質問がある場合は、以下に参加してください:

Azure AI Foundry Discord

製品に関するフィードバックや構築中のエラーについては、以下を訪問してください:

Azure AI Foundry Developer Forum


免責事項:
この文書は、AI翻訳サービスCo-op Translatorを使用して翻訳されています。正確性を追求しておりますが、自動翻訳には誤りや不正確な部分が含まれる可能性があることをご承知ください。元の言語で記載された文書が正式な情報源とみなされるべきです。重要な情報については、専門の人間による翻訳を推奨します。この翻訳の使用に起因する誤解や誤解釈について、当方は一切の責任を負いません。