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

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

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

必要なもの

• 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 のあとにエラーが続いていないかを見てください。

サーバー側か 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 のたびに効きます。

依存は 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