mcp notion

MCP Server notion-texonom :

Навигация на MCP на основе Markdown с одной переменной ROOT_PAGE , что устраняет необходимость в токене.

• Страницы понятия преобразуются в примечания MimeType text/markdown .
• Поиск и получение соответствующих страниц на основе графического расстояния, учитывая родительские и справочные отношения.

Сервер модельного контекста (MCP) для управления и взаимодействия с примечаниями, основанными на понятиях. Этот сервер на основе TypeScript демонстрирует концепции MCP, интегрируя ресурсы, инструменты и побуждает эффективно взаимодействовать со страницами понятий.

Функции

Ресурсы

• Примечания к доступу : Перечислите и получайте страницы понятия как note:// uris с uuid -слизняками.
• Метаданные : каждый ресурс включает в себя заголовок, описание и контент в формате разметки.
• Типы MIME : Контент доступен в формате text/markdown .

Инструменты

• Примечания поиска : используйте инструмент search_notes для поиска страниц понятия, используя строку запроса.
  • Ввод: текст запроса на фильтрование соответствующих страниц.
  • Вывод: Содержание Markdown в соответствующих примечаниях.

Подсказки

• Суммируйте примечания : генерируйте резюме для индивидуальных страниц понятия.
  • Доступные подсказки:
    • summarize_note : суммируйте конкретную ноту URI.
    • suggest_refactor : предложить структурные улучшения.
    • suggest_fix : Определите потенциальные исправления для содержимого ноты.
    • suggest_enhance : рекомендовать улучшения для улучшения записки.
  • Ввод: страница понятия uri.
  • Вывод: структурированные сообщения для суммирования и улучшения.

Разработка

Настраивать

Установить зависимости:

pnpm install

Создайте проект:

pnpm build

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

pnpm watch

Конфигурация

Чтобы настроить сервер с понятием:

• Установить переменные среды:
  • ROOT_PAGE : идентификатор корневой страницы вашего рабочего пространства.

Установка для рабочего стола Claude

Чтобы использовать этот сервер с настольным компьютером Claude, добавьте конфигурацию:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

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

{
  "mcpServers" : {
    "notion-texonom" : {
      "command" : " node " ,
      "args" : [
        " /path/to/mcp/build/index.js "
      ],
      "env" : {
        "ROOT_PAGE" : " $SOME_UUID "
      }
    }
  }
}

Отладка

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

pnpm inspector

Инспектор предоставляет интерфейс на основе браузера для проверки связи на основе STDIO.

Ключевые технологии

• Интеграция понятия: питается @texonom/nclient и @texonom/cli.
• MCP SDK: реализует @modelcontextprotocol/sdk для операций сервера.