simple-mcp-example

MCP-сервер для работы с заметками. Позволяет создавать, просматривать и искать заметки, которые хранятся в локальных .md-файлах. Построен на @modelcontextprotocol/sdk и работает через транспорт stdio.

Описание сервера

Сервер управляет заметками, сохранёнными в виде Markdown-файлов в папке notes. Папка создаётся автоматически в текущем каталоге запуска (cwd). Каждая заметка — это отдельный .md-файл.

Структура заметки (каждая строка отдельно):

Автор: <$USER>
Дата: dd.mm.yyyy HH:mm

<текст заметки>

• Автор — берётся из переменной окружения $USER.

• Дата — дата и время создания.

• Текст — произвольное содержимое заметки.

Все пути к файлам защищены от path traversal (../, абсолютные пути).

Related MCP server: Manas

Тулы

Тулами являются вспомогательные функции для управления заметками

add_note

Создаёт новую заметку (или перезаписывает существующую).

Параметры:

• note_name (строка, required) — имя файла заметки; расширение .md добавляется автоматически.

• text (строка, required) — текст заметки. Можно передать явно или попросить модель сделать саммари/выжимку.

Пример вызова:

{
  "name": "add_note",
  "arguments": {
    "note_name": "встреча",
    "text": "Обсудили план на неделю и договорились о демо в пятницу."
  }
}

Результат: создаётся файл notes/встреча.md.

get_all_notes

Возвращает список имён всех заметок, отсортированных по дате (mtime файла) от старых к новым.

Параметры: нет.

Пример вызова:

{ "name": "get_all_notes" }

Пример результата:

встреча.md
идеи.md
рецепт.md

view_note_content

Возвращает полный текст заметки.

Параметры:

• note_name (строка, required) — имя заметки.

Пример вызова:

{
  "name": "view_note_content",
  "arguments": { "note_name": "встреча" }
}

Пример результата:

Автор: roman
Дата: 06.09.2026 14:30

Обсудили план на неделю и договорились о демо в пятницу.

search_notes

Ищет заметки по имени файла. Поиск регистронезависимый.

Параметры:

• pattern (строка, required) — паттерн для поиска в названиях файлов.

Пример вызова:

{
  "name": "search_notes",
  "arguments": { "pattern": "встре" }
}

Пример результата: встреча.md

search_in_files

Ищет паттерн в содержимом файлов. Поиск регистронезависимый. Для каждого совпадения выводит автора, дату и найденную строку с контекстом ±2 строки.

Параметры:

• pattern (строка, required) — паттерн для поиска в содержимом файлов.

Пример вызова:

{
  "name": "search_in_files",
  "arguments": { "pattern": "демо" }
}

Пример результата:

встреча.md
Автор: roman
Дата: 06.09.2026 14:30
Обсудили план на неделю и договорились о демо в пятницу.

Установка

Требования: Node.js (последняя стабильная версия).

npm install
npm run build

После сборки готовый к запуску файл — build/index.js.

Подключение к MCP-клиенту

Сервер работает через stdio. Пример конфигурации для MCP-клиента (например, Claude Desktop): MCP сервер подключается через скачивание пакета и указания команды и пути до файла index.js

{
  "mcpServers": {
    "my-simple-notes": {
      "command": "node",
      "args": ["/absolute/path/to/simple-mcp-example/build/index.js"]
    }
  }
}

Пример конфигурации в opencode v1

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "my-simple-notes": {
      "type": "local",
      "command": ["node", "./build/index.js"],
      "cwd": ".",
      "enabled": true
    }
  }
}

Запуск для разработки

npm install        # установка зависимостей
npm run build      # сборка
npx tsc --noEmit   # проверка типов
npm run lint       # линтер (ESLint)
npm test           # тесты (jest)

Для ручного запуска сервера через stdio:

node build/index.js