mcp-server-sample — メモを保存・検索する最小の MCP サーバー

メモを保存・検索するだけの、最小の MCP サーバーです。外部システムへは一切繋ぎません。 保存先は同じフォルダの notes.json 1ファイルだけです。

MCP の3つのプリミティブを、1つずつ持たせてあります。

プリミティブ	誰が決めるか	このサーバーでの中身
Tools	モデルが判断する	add_note（メモを追加）／search_notes（メモを検索）
Resources	AI アプリが取得して渡す	notes://all（保存済みメモの全件）
Prompts	ユーザーが明示的に選ぶ	weekly_review（今週のふりかえり）

必要なもの

• Node.js 24 以上（LTS。node --version で確認）
• git

セットアップ

git clone https://github.com/utakatano/mcp-server-sample.git
cd mcp-server-sample
npm install

npm install が通れば準備完了です。この時点では起動しません。 MCP サーバーは AI アプリが起動するので、自分でターミナルから走らせる必要はありません。

AI アプリに繋ぐ

Claude Code

claude mcp add notes -- node /絶対パス/mcp-server-sample/index.js

claude mcp list で ✔ Connected と出れば繋がっています。

Claude Desktop

設定 → Developer → 「Edit Config」で claude_desktop_config.json を開き、次を追記します。

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/絶対パス/mcp-server-sample/index.js"]
    }
  }
}

保存したら Claude Desktop を完全に終了して起動し直します（ウィンドウを閉じるだけでは反映されません）。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

動作確認

「来週までにネットワーク構成を確認する」とメモして

「ネットワーク」を含むメモを探して

notes.json が作られ、中身が増えていくのが確認できます。

保存先を変える

環境変数 NOTES_FILE に絶対パスを渡すと、保存先を変えられます。

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/絶対パス/mcp-server-sample/index.js"],
      "env": { "NOTES_FILE": "/絶対パス/my-notes.json" }
    }
  }
}

繋がらないとき

まずログを見ます。原因はたいていここに出ています。

tail -20 ~/Library/Logs/Claude/mcp-server-notes.log   # macOS
# Windows: %APPDATA%\Claude\logs\mcp-server-notes.log

Server started and connected successfully のあとにエラーが続いていないかを見てください。

ログに出ているもの	原因	対処
Cannot find module '/.../index.js'	args のパスが違う	リポジトリ直下で pwd を実行し、その出力＋/index.js を貼り直す
spawn node ENOENT	AI アプリから node が見つからない。nvm / volta などで PATH がシェルの設定にしかない場合に起きる	which node の出力（絶対パス）を command にそのまま書く
Cannot find package '@modelcontextprotocol/server'	依存が入っていない	リポジトリ直下で npm ci
ログが空、または更新されない	設定が読み込まれていない	JSON の構文（カンマ・括弧）を確認し、Claude Desktop を完全に終了（macOS は ⌘Q）してから起動し直す

サーバー側か AI アプリ側かの切り分けは、手元で直接叩くのが速いです。

printf '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}\n' \
  | node /絶対パス/mcp-server-sample/index.js

add_note と search_notes を含む JSON が返ればサーバーは正常です。その場合は AI アプリ側の設定（パス・JSON の書き方・再起動）を疑ってください。

サプライチェーン対策

npm パッケージの乗っ取りを想定した設定を .npmrc に入れてあります。npm install / npm ci のたびに効きます。

設定	何をするか
ignore-scripts=true	インストール時に依存パッケージのライフサイクルスクリプト（postinstall など）を実行しない。乗っ取られたパッケージが最初に使う実行経路を塞ぐ。npm start / npm run は従来どおり動く（pre / post スクリプトだけが走らなくなる）
save-exact=true	npm install <pkg> が package.json に ^ を付けず、完全固定で書く
min-release-age=7	公開から7日を過ぎたバージョンだけをインストールする。npm はこれを before=<7日前の日時> に変換して依存を解決する

依存は package.json で完全固定（@modelcontextprotocol/server は 2.0.0、zod は 4.4.3）、 package-lock.json に integrity ハッシュ付きで記録してあります。 lock のとおりに入れたいときは npm install ではなく npm ci を使ってください。

依存を更新するときは、意図して1つずつ上げます。

npm outdated
npm install @modelcontextprotocol/server@2.1.0   # save-exact により完全固定で書かれる
npm ls --all                                      # 増えた依存を目で確認する

ライセンス

MIT