mcp-server-sample
mcp-server-sample — メモを保存・検索する最小の MCP サーバー
メモを保存・検索するだけの、最小の MCP サーバーです。外部システムへは一切繋ぎません。
保存先は同じフォルダの notes.json 1ファイルだけです。
MCP の3つのプリミティブを、1つずつ持たせてあります。
プリミティブ | 誰が決めるか | このサーバーでの中身 |
Tools | モデルが判断する |
|
Resources | AI アプリが取得して渡す |
|
Prompts | ユーザーが明示的に選ぶ |
|
必要なもの
Node.js 24 以上(LTS。
node --versionで確認)git
Related MCP server: mcp-snippetbox
セットアップ
git clone https://github.com/utakatano/mcp-server-sample.git
cd mcp-server-sample
npm installnpm install が通れば準備完了です。この時点では起動しません。
MCP サーバーは AI アプリが起動するので、自分でターミナルから走らせる必要はありません。
AI アプリに繋ぐ
Claude Code
claude mcp add notes -- node /絶対パス/mcp-server-sample/index.jsclaude 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.jsonWindows:
%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.logServer started and connected successfully のあとにエラーが続いていないかを見てください。
ログに出ているもの | 原因 | 対処 |
|
| リポジトリ直下で |
| AI アプリから |
|
| 依存が入っていない | リポジトリ直下で |
ログが空、または更新されない | 設定が読み込まれていない | 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.jsadd_note と search_notes を含む JSON が返ればサーバーは正常です。その場合は AI アプリ側の設定(パス・JSON の書き方・再起動)を疑ってください。
サプライチェーン対策
npm パッケージの乗っ取りを想定した設定を .npmrc に入れてあります。npm install / npm ci のたびに効きます。
設定 | 何をするか |
| インストール時に依存パッケージのライフサイクルスクリプト( |
|
|
| 公開から7日を過ぎたバージョンだけをインストールする。npm はこれを |
依存は 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
Available Tools
2 toolsadd_noteメモを追加するA
メモを1件保存する。打ち合わせの決定事項や、あとで思い出したいことを記録するときに使う。
Inputs: text (required), tags.
search_notesメモを検索するB
保存済みのメモをキーワードで検索する。本文とタグの両方を対象にする。
Inputs: keyword (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: one creates/ stores a note, the other retrieves notes via search. There is no overlap or ambiguity between writing and searching.
Both tool names follow a consistent verb_noun pattern (add_note, search_notes) using lowercase with underscores. The naming is predictable and clear.
With only 2 tools, the set feels minimal. While the tools cover basic create and read/search operations, the server's purpose (saving and retrieving notes) could reasonably include more tools (e.g., update, delete, list tags) to avoid being overly thin.
The domain is a personal note-taking system, but only add and search operations are provided. Missing critical operations like update, delete, and get all notes (without search) create significant gaps that would frustrate or block a typical agent workflow.
Maintenance
Related MCP Connectors
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables adding, getting, and listing notes through MCP, with state persisted to a JSON file in the home directory.MIT
- AlicenseNot gradedqualityCmaintenanceEnables managing notes through a simple MCP server, providing tools to add, retrieve, update, delete, and list notes for use with Claude Desktop.MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI clients to create, list, and search notes stored in a local JSON file through the Model Context Protocol.-
- AlicenseNot gradedqualityCmaintenanceEnables Claude Desktop to add, retrieve, update, delete, and list notes persisted in a JSON file whose path is set via MCP_NOTES_FILE or --notes-file, with atomic, lock-protected saves.MIT