mcp-server-sample
mcp-server-sample — минимальный MCP-сервер для сохранения и поиска заметок
Это минимальный MCP-сервер, который только сохраняет и ищет заметки. Он не подключается ни к каким внешним системам.
Данные хранятся в единственном файле notes.json в той же папке.
Сервер содержит по одному из трёх примитивов MCP.
Примитив | Кто решает | Содержимое в этом сервере |
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 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.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.logПроверьте, нет ли ошибок после строки Server 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.jsЕсли возвращается JSON с add_note и search_notes, сервер работает нормально. В этом случае проверяйте настройки AI-приложения (путь, формат JSON, перезапуск).
Защита цепочки поставок
В файл .npmrc добавлены настройки на случай компрометации npm-пакетов. Они действуют при каждом npm install / npm ci.
Настройка | Что делает |
| Не выполняет скрипты жизненного цикла зависимых пакетов (например, |
|
|
| Устанавливает только версии, опубликованные более 7 дней назад. npm преобразует это в |
Зависимости в package.json зафиксированы точно (@modelcontextprotocol/server — 2.0.0, zod — 4.4.3),
в package-lock.json записаны с хешами integrity.
Если нужно установить в точности по lock-файлу, используйте npm ci, а не npm install.
При обновлении зависимостей обновляйте их по одной осознанно.
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