Notion ReadOnly MCP-сервер

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

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

Конструкция «только для чтения» : ориентирована исключительно на операции по извлечению данных, обеспечивая безопасный доступ к контенту Notion.
Минимизированный набор инструментов : сокращено количество доступных инструментов Notion API с 15+ до 6 основных для анализа документов.
Параллельная обработка : повышение производительности за счет реализации асинхронных и параллельных запросов API для извлечения содержимого блоков, что значительно сокращает время отклика.
Расширенный доступ к базе данных : добавлена поддержка операций по извлечению базы данных, свойств страницы и комментариев.
Оптимизировано для помощников на основе ИИ : значительное сокращение количества инструментов решает проблему «Слишком большое количество инструментов может снизить производительность» в помощниках на основе ИИ, таких как Cursor, которые ограничивают модели примерно 40 инструментами.

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

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

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

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

Установка

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

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

Создание токена интеграции Notion

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

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

Возможности токена интеграции Notion, показывающие, что прочитанное содержимое отмечено

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

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

Этот оптимизированный сервер предоставляет только основные инструменты 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+ в стандартной реализации), мы гарантируем:

Лучшая производительность в помощниках с искусственным интеллектом, таких как Курсор и Клод, которые имеют ограничения по количеству инструментов.
Снижение когнитивной нагрузки на модели ИИ при выборе подходящих инструментов
Более быстрое время отклика с меньшим количеством вариантов API, которые необходимо учитывать
Повышенная безопасность за счет минимизации площади поверхности API

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

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

Рекурсивный поиск : автоматически просматривает всю структуру страницы, включая вложенные блоки.
Параллельная обработка : извлекает несколько блоков и их дочерних элементов одновременно для максимальной производительности.
Интеллектуальное кэширование : сохраняет извлеченные данные, чтобы минимизировать избыточные вызовы API.
Всеобъемлющий контент : включает страницы, блоки, базы данных, комментарии и подробную информацию о недвижимости.
Настраиваемая глубина : контролируйте уровень рекурсии, чтобы найти баланс между детализацией и производительностью.

{
  "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:

Несколько запросов объединяются и обрабатываются одновременно.
Пагинация для дочерних блоков выполняется автоматически.
Результаты эффективно агрегируются перед возвратом
Консольное ведение журнала обеспечивает наглядность процесса, не влияя на формат ответа.

Примеры

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

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

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

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

Get the structure of database 8a6b35e6e67f802fa7e1d27686f017f2

Разработка

Строить:

pnpm build

Выполнять:

pnpm dev

Лицензия

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

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

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

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

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

Более быстрые и надежные ответы от помощников на основе искусственного интеллекта
Повышенная точность при взаимодействии с контентом Notion
Лучшая общая производительность за счет целенаправленной разработки API

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Оптимизированный сервер только для чтения, позволяющий помощникам на основе искусственного интеллекта эффективно запрашивать и извлекать контент Notion, отличающийся параллельной обработкой и минимальным набором инструментов из 7 основных операций только для чтения.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MySQL MCP Server
designcomputer
A
security
A
license
A
quality
Allows AI assistants to list tables, read data, and execute SQL queries through a controlled interface, making database exploration and analysis safer and more structured.
Last updated -
1
360
Python
MIT License
Tavily MCP Serverofficial
tavily-ai
A
security
A
license
A
quality
This server enables AI systems to integrate with Tavily's search and data extraction tools, providing real-time web information access and domain-specific searches.
Last updated -
2
5,348
378
JavaScript
MIT License
Metabase Server MCP
berry-street
-
security
F
license
-
quality
Enables AI assistants to interact with Metabase, providing access to dashboards, questions, databases, and tools for executing queries and viewing data through natural language.
Last updated -
JavaScript
Notion MCP Serverofficial
makenotion
A
security
A
license
A
quality
An MCP server that enables AI assistants to interact with the Notion API, allowing them to search, read, comment on, and create content in Notion workspaces through natural language commands.
Last updated -
19
14,267
1,775
TypeScript
MIT License

View all related MCP servers

Notion ReadOnly MCP Server