はじめに
以前、カメラで撮影した写真をGoogleレンズ風に解説してくれるMCPサーバーを作りました。
コードを1行も書かずに「カメラで撮影してGoogleレンズ風に解説するMCPサーバー」を作った(GitHub Copilot + Gemini API)
このMCPサーバー(server.js)は、Node.jsで動いています。ほかにも、MCPサーバーや、AI関連のツールには、「Node.jsが入っていること」を前提にしたものが多くあります。
そこでこの記事では、次のことをまとめました。
- Node.jsとは何か
- npmとは何か
- どのバージョンを入れればよいか
- Windowsへのインストール方法
- 入れたあとの動作確認と、よくあるトラブル
画面の表示や、バージョンの状況は、2026年11月2日時点のものです。変わることがあるので、最新の内容は公式サイトで確認してください。
1. Node.jsとは
1-1. JavaScriptを、ブラウザの外で動かすための実行環境
JavaScriptは、もともと、Webブラウザの中で動くプログラミング言語です。Webページに動きをつけるために使われてきました。
Node.js(ノード・ジェイエス)は、そのJavaScriptを、ブラウザの外(自分のパソコンやサーバー)で動かすための実行環境です。実行環境とは、プログラムを読み取って、実際に動かしてくれるソフトのことです。
たとえば、hello.js というJavaScriptのファイルがあるとき、Node.jsが入っていれば、次のコマンドで動かせます。
node hello.js
Node.jsは、プログラミング言語ではなく、JavaScriptを動かすための土台、というイメージです。
1-2. Node.jsで動いているもの
Node.jsは、次のような用途で使われています。
- Webサーバーやバックエンドのプログラム
- コマンドラインのツール(開発を助ける小さなツール)
- 前回のカメラのMCPサーバーのような、AIとつなぐための小さなサーバー
「自分でJavaScriptを書く予定はない」という方でも、使いたいツールがNode.jsを必要とするために、入れることになる場合があります。
2. npmとは
2-1. 部品をダウンロードして管理するための道具
npm(エヌ・ピー・エム)は、Node.jsで使う部品(パッケージ)をダウンロードして、管理するための道具です。Node.jsをインストールすると、一緒に入ります。
プログラムを作るとき、すべてを自分で書くのではなく、世の中に公開されている便利な部品を組み合わせて作るのが普通です。たとえば、「日付の表示を整える部品」「ファイルを読み書きする部品」などです。npmは、そうした部品が公開されている場所(レジストリ)から、必要な部品を取ってきてくれます。
スマホにアプリを入れるときの、アプリストアに近いイメージです。
| 役割 | |
|---|---|
| Node.js | JavaScriptを動かす土台(エンジン) |
| npm | 部品(パッケージ)を取ってきて、管理する道具 |
2-2. 出てくるファイルとフォルダ
npmを使い始めると、プロジェクトのフォルダに、次のものができます。
| 名前 | 内容 |
|---|---|
package.json |
そのプロジェクトの情報や、必要な部品の一覧が書かれた設定ファイル |
node_modules |
ダウンロードされた部品が入るフォルダ。中身は多くなりがち |
package-lock.json |
実際に入れた部品の、細かいバージョンを記録したファイル |
node_modules は、package.json があれば、あとからいつでも作り直せます。そのため、Gitなどには、普通は含めません。
2-3. よく使うコマンド
| コマンド | 内容 |
|---|---|
npm init -y |
package.json を、初期設定で作る |
npm install |
package.json に書かれた部品を、まとめてダウンロードする |
npm install 部品の名前 |
指定した部品を追加する(package.json にも記録される) |
npm run スクリプト名 |
package.json に登録されたコマンドを実行する |
ほかの人が作ったMCPサーバーなどを使うときは、そのフォルダで npm install を実行する、という手順がよく出てきます。
2-4. npxとは
npx(エヌ・ピー・エックス)も、npmと一緒に入るコマンドです。部品を、自分のパソコンにしっかり入れずに、その場でダウンロードして、1回だけ実行するときに使います。
MCPサーバーの設定例などで、npx を使った書き方が出てくることがあります。「Node.jsが入っていないと動かない」と言われる理由の1つです。
npmで取ってくる部品は、世界中の人が公開したものです。使うのは、信頼できるものだけにしてください。 名前が似た、偽の部品が公開されていることもあります。手順書などに書かれた名前は、そのままコピーして使うのが安全です。
3. どのバージョンを入れるか
Node.jsには、いくつかのバージョンがあります。迷ったら、「LTS」と書かれたバージョンを選んでください。
LTSは、Long Term Support(長期サポート)の略で、長い期間、安定して使えるように、更新が続けられるバージョンです。普段使いや、ツールを動かす目的には、LTSが向いています。
2026年11月7日時点では、2026年10月28日に、Node.js 26系がLTSになったと、公式のリリースページに書かれています。ほかに、24系と22系もサポートされています。20系は、サポートが終了しています。
最新のLTSは、時期によって変わります。実際に入れるときは、公式サイトで「LTS」と表示されているバージョンを選ぶのが確実です。
使いたいツールが、特定のバージョンを指定している場合は、そのツールの説明に従ってください。
4. Windowsへのインストール手順
この記事では、Windowsを例に説明します。MacやLinuxの場合も、公式サイトのダウンロードページから、それぞれの環境用のものを入れられます。
4-1. インストーラーをダウンロードする
- ブラウザで、Node.jsの公式サイトを開きます。
- ダウンロードのページで、LTSと書かれたバージョンの、Windows用のインストーラー(
.msi)を選んで、ダウンロードします。
Node.jsの公式サイト以外で配布されているインストーラーは、使わないでください。アドレスが、nodejs.org になっていることを確認しましょう。
4-2. インストーラーを実行する
ダウンロードした .msi ファイルをダブルクリックして、画面の案内に従って進めます。基本的には、初期設定のまま、「Next」を押していけば問題ありません。
- ようこそ画面で、「Next」を押す
- 使用許諾契約書を確認して、同意のチェックを入れ、「Next」を押す
- インストール先のフォルダは、そのままで「Next」を押す
- 「Custom Setup」の画面は、そのままで「Next」を押す(Node.jsの本体、npm、PATHへの追加などが、選ばれた状態になっています)
- 追加のツール(ネイティブモジュール用のツール)に関する画面が出た場合は、使い方に応じて選ぶ。分からなければ、チェックなしで「Next」を押す
- 「Install」を押して、完了するまで待つ
「PATHへの追加」は、どのフォルダからでも node や npm のコマンドを使えるようにする設定です。チェックを外さないでください。
画面の表示や、選択肢の内容は、バージョンによって変わることがあります。
4-3. インストールできたか確認する
インストール前から開いていたターミナルやVSCodeは、いったんすべて閉じて、開き直してください。開いたままだと、新しく入れたNode.jsが認識されません。
開き直したターミナル(PowerShellなど)で、次のコマンドを実行します。
node -v
npm -v
どちらも、バージョンの番号(v から始まる数字など)が表示されれば、インストールは成功です。表示される番号は、入れた時期によって違います。
4-4. 別の方法(補足)
インストーラーのほかにも、次のような入れ方があります。まずは、公式のインストーラーで十分です。
-
wingetを使う方法:Windowsのパッケージ管理ツール
wingetで、コマンドから入れる方法です。使えるかどうかは、環境によります -
バージョン管理ツールを使う方法:
nvm-windows、fnm、Voltaなどのツールで、複数のバージョンを切り替えながら使えます。プロジェクトごとに、必要なバージョンが違う場合などに便利です
5. 動作確認をしてみる
インストールできたら、簡単なプログラムを動かして、Node.jsとnpmの動きを確かめてみましょう。
5-1. Node.jsでプログラムを動かす
PowerShellで、次のコマンドを順に実行して、作業用のフォルダを作ります。
mkdir hello-node
cd hello-node
そのフォルダに、hello.js というファイルを作って、次の1行を書きます(VSCodeなどで作れます)。
console.log("Hello, Node.js!");
PowerShellで、次のコマンドを実行します。
node hello.js
Hello, Node.js! と表示されれば、Node.jsは正しく動いています。
5-2. npmで部品を入れてみる
次に、npmで、日付を扱う部品(dayjs)を入れて、使ってみます。
npm init -y
npm install dayjs
package.json と node_modules ができたはずです。hello.js を、次のように書き換えます。
const dayjs = require("dayjs");
console.log("今日は、" + dayjs().format("YYYY年MM月DD日") + "です。");
もう一度、実行します。
node hello.js
今日の日付が表示されれば、npmで取ってきた部品を、プログラムから使えています。
6. よくあるトラブル
| 症状 | 考えられる原因と対処 |
|---|---|
node が認識されない(「用語 'node' は、コマンドレット…として認識されません」など) |
インストール前から開いていたターミナルやVSCodeを、閉じて開き直していない。それでも直らない場合は、インストール時にPATHへの追加を外していないかを確認し、必要なら、インストーラーを再実行する |
npm を実行すると、「このシステムではスクリプトの実行が無効になっているため…」というエラーが出る(PowerShellの場合) |
PowerShellの実行ポリシーが、スクリプトの実行を止めている。コマンドプロンプトで実行するか、PowerShellで Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned を実行する。会社のパソコンなど、設定が管理されている場合は、管理者に確認する |
| インストールの途中で、権限のエラーが出る | 会社や学校のパソコンでは、ソフトを入れる権限がないことがある。管理者に相談する |
| 古いバージョンが表示される | 別のNode.jsが、すでに入っている可能性がある。Get-Command node で、どこにあるNode.jsが使われているかを確認する |
Set-ExecutionPolicy は、PowerShellのセキュリティの設定を変えるものです。内容を理解したうえで、実行してください。心配な場合は、コマンドプロンプトを使えば、変更せずに済みます。
まとめ
- Node.jsは、JavaScriptを、ブラウザの外で動かすための実行環境。前回のMCPサーバーも、Node.jsで動いている
- npmは、Node.jsで使う部品(パッケージ)をダウンロードして、管理する道具。Node.jsと一緒に入る
-
npxは、部品を、その場でダウンロードして1回だけ実行するためのコマンド - 迷ったら、公式サイトで「LTS」と書かれたバージョンを選ぶ
- インストーラーで入れたあとは、ターミナルやVSCodeを開き直して、
node -vとnpm -vで確認する - npmで取ってくる部品は、信頼できるものだけを使う
参考
その他の記事は BB研究所 で公開しています。