upnote-mcp

upnote-mcp — это MCP-сервер только для чтения, предназначенный для чтения локальных данных UpNote из SQLite через stdio.

Это неофициальный проект, не связанный с UpNote, не одобренный им и не поддерживаемый им.

Возможности

• search_notes: поиск заметок по заголовку, тексту или сводке

• list_recent_notes: список последних изменённых заметок

• list_notes_this_week: список заметок, изменённых на текущей неделе

• list_notes_this_month: список заметок, изменённых в текущем месяце

• find_notes: объединение фильтров по периоду, ключевому слову и тегу в одном вызове

• open_note: открытие заметки в приложении UpNote по идентификатору заметки

• get_note: получение полного содержимого заметки по идентификатору заметки

• open_notebook: открытие блокнота в приложении UpNote по идентификатору блокнота

• list_notebooks: список блокнотов с количеством заметок

• create_note: создание новой заметки через официальную схему URL UpNote

• list_tags: список тегов

• search_by_tag: список заметок для тега

Этот проект намеренно сделан только для чтения. Он не записывает данные в базу данных UpNote. Безопасное создание заметок и действия по открытию выполняются через официальную схему URL UpNote, а не через прямую запись в базу.

Related MCP server: upnote-lens-mcp

Имя пакета

Этот пакет подготовлен для публикации как @bellx2/upnote-mcp.

Требования

• macOS

• bun установлен на машине, где запускается сервер

• Установлено настольное приложение UpNote

• Путь к базе данных UpNote по умолчанию:

~/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3

Если ваша база данных находится в другом месте, укажите UPNOTE_DB.

Установка

bun install

Запуск

bun run start

Для обычного использования предпочтительнее опубликованный пакет:

bunx @bellx2/upnote-mcp

или:

npx @bellx2/upnote-mcp

Поддержка npx по-прежнему зависит от установленного bun, так как этот пакет использует специфичные для Bun API, такие как bun:sqlite.

Для разработки с отслеживанием изменений:

bun run dev

Переменные окружения

• UPNOTE_DB: абсолютный путь к upnote.sqlite3

Пример:

export UPNOTE_DB="$HOME/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3"

Разрешения

При первом запуске ваш MCP-клиент может показать запросы на разрешения для выполнения команд и доступа к локальным файлам.

Это ожидаемо, так как сервер:

• запускается через bun

• читает вашу локальную базу данных UpNote SQLite

• может открывать приложение UpNote для open_note, open_notebook или create_note

Если вы отклоните эти разрешения, поиск и получение заметок работать не будут. После предоставления доступа, возможно, потребуется перезапустить MCP-сервер в Cursor или Claude Desktop.

Пример конфигурации MCP

Рекомендуется: опубликованный пакет

Cursor

{
  "mcpServers": {
    "upnote": {
      "command": "bunx",
      "args": ["@bellx2/upnote-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "upnote": {
      "command": "bunx",
      "args": ["@bellx2/upnote-mcp"]
    }
  }
}

Локальная разработка (рабочая копия)

Cursor

{
  "mcpServers": {
    "upnote": {
      "command": "/absolute/path/to/bun",
      "args": ["run", "/absolute/path/to/upnote-mcp/src/index.ts"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "upnote": {
      "command": "/absolute/path/to/bun",
      "args": ["run", "/absolute/path/to/upnote-mcp/src/index.ts"]
    }
  }
}

Примеры рабочих процессов

Попробуйте такие запросы:

• Search UpNote for "travel" and show me the first result

• Show me my 10 most recent UpNote notes

• Show me this week's notes

• Show me this month's notes

• Find this week's AI notes

• Find this month's notes tagged meeting

• List my UpNote tags and open the note that matches the tag "meeting"

• Find notes about "launch", summarize them, and create a new UpNote note with the summary

• List notebooks and open the one named "Research"

Справочник по инструментам

search_notes

Входные данные:

{
  "query": "travel",
  "limit": 5
}

list_recent_notes

Входные данные:

{
  "limit": 10
}

list_notes_this_week

Входные данные:

{
  "limit": 20
}

list_notes_this_month

Входные данные:

{
  "limit": 20
}

find_notes

Входные данные:

{
  "period": "this_week",
  "query": "AI",
  "limit": 10
}

Или:

{
  "period": "this_month",
  "tag": "meeting",
  "limit": 10
}

get_note

Входные данные:

{
  "id": "019fd239-a98a-742b-b75b-cee66e7aa830"
}

open_note

Входные данные:

{
  "id": "019fd239-a98a-742b-b75b-cee66e7aa830"
}

open_notebook

Входные данные:

{
  "id": "3f03c742-1270-4d35-a5bc-c7d98580d6fc"
}

list_notebooks

Входные данные:

{}

list_tags

Входные данные:

{}

search_by_tag

Входные данные:

{
  "tag": "meeting",
  "limit": 5
}

create_note

Входные данные:

{
  "title": "Meeting Notes",
  "text": "# Summary\n\nDraft created by MCP.",
  "markdown": true,
  "newWindow": false
}

Проверка

bun run check
bun run smoke

Японская версия README

Предыдущая японская версия README доступна в файле README_ja.md.