Skip to content

00-setup.md

Latest commit

 

History

History
355 lines (241 loc) · 13 KB

00-setup.md

File metadata and controls

355 lines (241 loc) · 13 KB

00: 開発環境

このステップでは、ワークショップ用の開発環境をセットアップします。

前提条件

準備についてはREADMEドキュメントを参照してください。

はじめに

GitHub Codespacesを使用

  1. このリンクをクリックしてください 👉 Open in GitHub Codespaces

  2. GitHub Codespaceインスタンスの準備ができたら、ターミナルを開いて以下のコマンドを実行し、必要なものがすべて適切にインストールされていることを確認してください。

    # Node.js
node --version
npm --version
    # .NET SDK
dotnet --list-sdks
    # PowerShell
pwsh --version

  3. リポジトリのステータスを確認します。

    git remote -v

    以下の出力が表示されるはずです：

    origin  https://github.com/Azure-Samples/mcp-workshop-dotnet.git (fetch)
origin  https://github.com/Azure-Samples/mcp-workshop-dotnet.git (push)

    上記と異なるものが表示される場合は、GitHub Codespaceインスタンスを削除して再作成してください。

  4. 以下のコマンドを実行して、このリポジトリをあなたのGitHubアカウントにフォークします。

    git remote -v > remote.txt
git add . && git commit -m "Add remote.txt for forking"

    以下のようなメッセージが表示される可能性があります：

    You don't have write access to the Azure-Samples/mcp-workshop-dotnet repository, so you cannot push changes to it.
To obtain write access we will point this codespace at your fork of Azure-Samples/mcp-workshop-dotnet, creating that fork if it doesn't exist.

Would you like to proceed?

    yを入力すると、このリポジトリが自動的にあなたのGitHubアカウントにフォークされます。

  5. リモートリポジトリを再度確認します。

    git remote -v

    originとupstreamの両方を確認できるはずです。

    origin  https://github.com/<your GitHub ID>/mcp-workshop-dotnet.git (fetch)
origin  https://github.com/<your GitHub ID>/mcp-workshop-dotnet.git (push)
upstream        https://github.com/Azure-Samples/mcp-workshop-dotnet (fetch)
upstream        https://github.com/Azure-Samples/mcp-workshop-dotnet (push)

  6. MCPサーバーをセットアップセクションに進んでください。

👇👇👇 ローカルマシンでVS Codeを使用したい場合は、以下の手順に従ってください。以下のセクションはGitHub Codespacesを使用する人には適用されません。👇👇👇

Visual Studio Codeを使用

PowerShellをインストール 👉 Windowsユーザー向け

  1. PowerShellがすでにインストールされているかを確認します。

    # Bash/Zsh
which pwsh
    # PowerShell
Get-Command pwsh

    pwshのコマンドパスが表示されない場合は、まだPowerShellがインストールされていません。PowerShellインストールページにアクセスして、指示に従ってください。

  2. PowerShellのバージョンを確認します。

    pwsh --version

    バージョン 7.5.0 以上が推奨されます。バージョンがそれより低い場合は、PowerShellインストールページにアクセスして、指示に従ってください。

node.jsをインストール

  1. node.jsがすでにインストールされているかを確認します。

    # Bash/Zsh
which node
    # PowerShell
Get-Command node

    nodeのコマンドパスが表示されない場合は、まだnode.jsがインストールされていないことを意味します。node.jsダウンロードページにアクセスして、指示に従ってください。

  2. node.jsのバージョンを確認します。

    node --version

    バージョン 22.17.x（最新のLTS）が推奨されます。バージョンがそれより低い場合は、node.jsダウンロードページにアクセスして、指示に従ってください。

git CLIをインストール

  1. git CLIがすでにインストールされているかを確認します。

    # Bash/Zsh
which git
    # PowerShell
Get-Command git

    gitのコマンドパスが表示されない場合は、まだgit CLIがインストールされていません。git CLIインストールページにアクセスして、指示に従ってください。

  2. git CLIのバージョンを確認します。

    git --version

    バージョン 2.39.0 以上が推奨されます。バージョンがそれより低い場合は、git CLIインストールページにアクセスして、指示に従ってください。

GitHub CLIをインストール

  1. GitHub CLIがすでにインストールされているかを確認します。

    # Bash/Zsh
which gh
    # PowerShell
Get-Command gh

    ghのコマンドパスが表示されない場合は、まだGitHub CLIがインストールされていません。GitHub CLIインストールページにアクセスして、指示に従ってください。

  2. GitHub CLIのバージョンを確認します。

    gh --version

    バージョン 2.65.0 以上が推奨されます。バージョンがそれより低い場合は、GitHub CLIインストールページにアクセスして、指示に従ってください。

  3. GitHubにサインインしているかを確認します。

    gh auth status

    まだサインインしていない場合は、gh auth loginを実行してサインインしてください。

Docker Desktopをインストール

  1. Docker Desktopがすでにインストールされているかを確認します。

    # Bash/Zsh
which docker
    # PowerShell
Get-Command docker

    dockerのコマンドパスが表示されない場合は、まだDocker Desktopがインストールされていません。Docker Desktopインストールページにアクセスして、指示に従ってください。

  2. Docker CLIのバージョンを確認します。

    docker --version

    バージョン 28.0.4 以上が推奨されます。バージョンがそれより低い場合は、Docker Desktopインストールページにアクセスして、指示に従ってください。

Visual Studio Codeをインストール

  1. VS Codeがすでにインストールされているかを確認します。

    # Bash/Zsh
which code
    # PowerShell
Get-Command code

    codeのコマンドパスが表示されない場合は、まだVS Codeがインストールされていません。Visual Studio Codeインストールページにアクセスして、指示に従ってください。

  2. VS Codeのバージョンを確認します。

    code --version

    バージョン 1.99.0 以上が推奨されます。バージョンがそれより低い場合は、Visual Studio Codeインストールページにアクセスして、指示に従ってください。

    注意: codeコマンドを実行できない場合があります。その場合は、セットアップのためにこのドキュメントに従ってください。

Visual Studio Codeを開始

  1. 作業ディレクトリを作成します。

  2. このリポジトリをフォークしてローカルマシンにクローンするコマンドを実行します。

    gh repo fork Azure-Samples/mcp-workshop-dotnet --clone

  3. クローンしたディレクトリに移動します。

    cd mcp-workshop-dotnet

  4. ターミナルからVS Codeを実行します。

    code .

  5. VS Code内で新しいターミナルを開いて、以下のコマンドを実行してリポジトリのステータスを確認します。

    git remote -v

    以下の出力が表示されるはずです。originにAzure-Samplesが表示される場合は、フォークしたリポジトリから再度クローンしてください。

    origin  https://github.com/<あなたのGitHub ID>/mcp-workshop-dotnet.git (fetch)
origin  https://github.com/<あなたのGitHub ID>/mcp-workshop-dotnet.git (push)
upstream        https://github.com/Azure-Samples/mcp-workshop-dotnet.git (fetch)
upstream        https://github.com/Azure-Samples/mcp-workshop-dotnet.git (push)

  6. 両方の拡張機能がインストールされているかを確認します：GitHub CopilotとGitHub Copilot Chat。

    # Bash/Zsh
code --list-extensions | grep github.copilot
    # PowerShell
code --list-extensions | Select-String "github.copilot"

    何も表示されない場合は、まだこれらの拡張機能がインストールされていません。以下のコマンドを実行して拡張機能をインストールしてください。

    code --install-extension "github.copilot" --force && code --install-extension "github.copilot-chat" --force

MCPサーバーをセットアップ

  1. $REPOSITORY_ROOTの環境変数を設定します。

    # bash/zsh
REPOSITORY_ROOT=$(git rev-parse --show-toplevel)
    # PowerShell
$REPOSITORY_ROOT = git rev-parse --show-toplevel

  2. MCPサーバーの設定をコピーします。

    # bash/zsh
mkdir -p $REPOSITORY_ROOT/.vscode
cp -r $REPOSITORY_ROOT/docs/.vscode/. \
      $REPOSITORY_ROOT/.vscode/
    # PowerShell
New-Item -ItemType Directory -Path $REPOSITORY_ROOT/.vscode -Force
Copy-Item -Path $REPOSITORY_ROOT/docs/.vscode/* `
          -Destination $REPOSITORY_ROOT/.vscode/ -Recurse -Force

GitHub Copilotエージェントモードを確認

  1. GitHub CodespaceまたはVS Codeの上部にあるGitHub Copilotアイコンをクリックして、GitHub Copilotウィンドウを開きます。

    Open GitHub Copilot Chat

  2. ログインまたはサインアップを求められた場合は、そうしてください。無料です。

  3. GitHub Copilotエージェントモードを使用していることを確認してください。

    GitHub Copilot Agent Mode

  4. モデルをGPT-4.1またはClaude Sonnet 4に選択してください。

完了しました。「開発環境」ステップを完了しました。次はステップ01：MCPサーバーに進みましょう。

このドキュメントはGitHub Copilotによってローカライズされました。そのため、誤りが含まれる可能性があります。不適切または間違った翻訳を見つけた場合は、issueを作成してください。