Notion ReadOnly MCP-сервер

В этом проекте реализуется оптимизированный сервер MCP, доступный только для чтения, для API Notion, с упором на производительность и эффективность, позволяющие помощникам на основе искусственного интеллекта запрашивать и извлекать контент Notion.

Ключевые улучшения

• Конструкция «только для чтения» : ориентирована исключительно на операции по извлечению данных, обеспечивая безопасный доступ к контенту Notion.

• Минимизированный набор инструментов : сокращено количество доступных инструментов Notion API с 15+ до 6 основных для анализа документов.

• Параллельная обработка : повышение производительности за счет реализации асинхронных и параллельных запросов API для извлечения содержимого блоков, что значительно сокращает время отклика.

• Расширенный доступ к базе данных : добавлена поддержка операций по извлечению базы данных, свойств страницы и комментариев.

• Оптимизировано для помощников на основе ИИ : значительное сокращение количества инструментов решает проблему «Слишком большое количество инструментов может снизить производительность» в помощниках на основе ИИ, таких как Cursor, которые ограничивают модели примерно 40 инструментами.

Related MCP server: notion-slim

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

Эта реализация, доступная только для чтения, предоставляет гораздо меньше инструментов по сравнению со стандартной интеграцией Notion API, что повышает производительность и совместимость с помощниками на основе искусственного интеллекта:

Сокращенный набор инструментов помогает оставаться в пределах рекомендуемых ограничений для оптимальной производительности ИИ-помощника, сохраняя при этом все основные функции.

Установка

1. Настройка интеграции в Notion:

Перейдите по ссылке https://www.notion.so/profile/integrations и создайте новую внутреннюю интеграцию или выберите существующую.

Хотя мы ограничиваем область действия Notion API, доступную только для операций чтения, существует ненулевой риск для данных рабочей области, если они доступны LLM. Пользователи, заботящиеся о безопасности, могут захотеть дополнительно настроить возможности интеграции.

Например, вы можете создать токен интеграции, доступный только для чтения, предоставив доступ только «Чтение содержимого» на вкладке «Конфигурация»:

2. Добавление конфигурации MCP в ваш клиент:

Использование npm:

Добавьте следующее в ваш .cursor/mcp.json или claude_desktop_config.json (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json )

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "notion-readonly-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

Использование Докера:

Добавьте следующее в ваш .cursor/mcp.json или claude_desktop_config.json :

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENAPI_MCP_HEADERS",
        "taewoong1378/notion-readonly-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

Не забудьте заменить ntn_**** на ваш секрет интеграции. Найдите его на вкладке конфигурации интеграции.

3. Подключение контента к интеграции:

Убедитесь, что к вашей интеграции подключены соответствующие страницы и базы данных.

Для этого зайдите на страницу, нажмите на три точки и выберите «Подключиться к интеграции».

Доступные инструменты

Этот оптимизированный сервер предоставляет только основные инструменты Notion API, доступные только для чтения:

• API-retrieve-a-page : Получить информацию о странице

• API-get-block-children : получение блоков содержимого страницы (с параллельной обработкой)

• API-retrieve-a-block : получение сведений о конкретном блоке

• API-retrieve-a-database : Получить информацию о базе данных

• API-retrieve-a-comment : Получить комментарии на странице или в блоке

• API-retrieve-a-page-property : получение определенной информации о свойствах со страницы

• API-get-one-pager : НОВОЕ! Рекурсивное извлечение полной страницы Notion со всеми ее блоками, базами данных и связанным контентом за один вызов

Ограничившись этими 7 основными инструментами (по сравнению с 15+ в стандартной реализации), мы гарантируем:

1. Лучшая производительность в помощниках с искусственным интеллектом, таких как Курсор и Клод, которые имеют ограничения по количеству инструментов.

2. Снижение когнитивной нагрузки на модели ИИ при выборе подходящих инструментов

3. Более быстрое время отклика с меньшим количеством вариантов API, которые необходимо учитывать

4. Повышенная безопасность за счет минимизации площади поверхности API

Автоматическое исследование контента

Новый инструмент API-get-one-pager предоставляет эффективный способ исследования страниц Notion без необходимости выполнения нескольких вызовов API:

• Рекурсивный поиск : автоматически просматривает всю структуру страницы, включая вложенные блоки.

• Параллельная обработка : извлекает несколько блоков и их дочерних элементов одновременно для максимальной производительности.

• Интеллектуальное кэширование : сохраняет извлеченные данные, чтобы минимизировать избыточные вызовы API.

• Всеобъемлющий контент : включает страницы, блоки, базы данных, комментарии и подробную информацию о недвижимости.

• Настраиваемая глубина : контролируйте уровень рекурсии, чтобы найти баланс между детализацией и производительностью.

Использование инструмента One Pager

{
  "page_id": "YOUR_PAGE_ID",
  "maxDepth": 5,               // Optional: Maximum recursion depth (default: 5)
  "includeDatabases": true,    // Optional: Include linked databases (default: true)
  "includeComments": true,     // Optional: Include comments (default: true)
  "includeProperties": true    // Optional: Include detailed page properties (default: true)
}

Эта возможность автоматического исследования особенно полезна для помощников на базе искусственного интеллекта, которым необходимо понимать все содержимое страницы Notion, не выполняя десятки отдельных вызовов API, что обеспечивает гораздо более быстрые и эффективные ответы.

Асинхронная обработка

Сервер реализует передовые методы параллельной обработки для обработки больших документов Notion:

• Несколько запросов объединяются и обрабатываются одновременно.

• Пагинация для дочерних блоков выполняется автоматически.

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

• Консольное ведение журнала обеспечивает наглядность процесса, не влияя на формат ответа.

Примеры

1. Используя следующую инструкцию:

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

ИИ эффективно извлечет данные страницы с помощью параллельной обработки содержимого блока.

2. Использование информации базы данных:

Get the structure of database 8a6b35e6e67f802fa7e1d27686f017f2

Разработка

Строить:

pnpm build

Выполнять:

pnpm dev

Лицензия

Массачусетский технологический институт

Преимущества производительности ИИ-помощника

Современные помощники на основе искусственного интеллекта, такие как Курсор и Клод, имеют ограничения по количеству инструментов, с которыми они могут эффективно работать:

• Большинство моделей не поддерживают более 40 инструментов в общей сложности.

• Слишком много инструментов может ухудшить общую производительность и возможности рассуждения.

• Сложные наборы инструментов увеличивают задержку ответа и затрудняют принятие решений

Эта реализация только для чтения намеренно уменьшает поверхность API Notion для устранения этих ограничений, сохраняя при этом всю необходимую функциональность. Результат:

• Более быстрые и надежные ответы от помощников на основе искусственного интеллекта

• Повышенная точность при взаимодействии с контентом Notion

• Лучшая общая производительность за счет целенаправленной разработки API