Skip to main content
Glama

mcp-server-sample — минимальный MCP-сервер для сохранения и поиска заметок

Это минимальный MCP-сервер, который только сохраняет и ищет заметки. Он не подключается ни к каким внешним системам. Данные хранятся в единственном файле notes.json в той же папке.

Сервер содержит по одному из трёх примитивов MCP.

Примитив

Кто решает

Содержимое в этом сервере

Tools

Определяет модель

add_note (добавить заметку) / search_notes (искать заметки)

Resources

AI-приложение получает и передаёт

notes://all (все сохранённые заметки)

Prompts

Пользователь явно выбирает

weekly_review (обзор за неделю)

Требования

  • 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.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. Возникает, если PATH задан только в настройках оболочки (nvm/volta и т.п.)

Вставьте вывод 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

Если возвращается JSON с add_note и search_notes, сервер работает нормально. В этом случае проверяйте настройки AI-приложения (путь, формат JSON, перезапуск).

Защита цепочки поставок

В файл .npmrc добавлены настройки на случай компрометации npm-пакетов. Они действуют при каждом 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 ci, а не npm install.

При обновлении зависимостей обновляйте их по одной осознанно.

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

Лицензия

MIT

Available Tools

2 tools
add_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

    A3.5/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern (add_note, search_notes) using lowercase with underscores. The naming is predictable and clear.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers