Сервер Notion MCP

Сервер, который подключается к API Notion и предоставляет функциональные возможности через протокол контекста машины Клода (MCP).

Функции

• Поиск страниц Notion по названию или содержанию

• Получить сведения о странице и ее содержимое

• Запросить базу данных Notion

• Создавайте новые страницы в Notion

Related MCP server: Notion MCP Server

Настраивать

1. Клонируйте этот репозиторий:

git clone https://github.com/yourusername/notion-mcp-server.git
cd notion-mcp-server

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

npm install

3. Создайте в корневом каталоге файл .env со следующим содержимым:

NOTION_API_KEY=your_notion_api_key_here
PORT=3000
# Optional: if you want to query a specific database by default
NOTION_DATABASE_ID=your_notion_database_id_here

4. Получите свой ключ API Notion:

   • Перейдите по ссылке https://www.notion.so/my-integrations

   • Создать новую интеграцию

   • Скопируйте «Токен внутренней интеграции»

   • Добавьте этот токен как NOTION_API_KEY в файл .env

5. Подключите интеграцию Notion к своему рабочему пространству:

   • Перейдите на страницу или в базу данных в вашем рабочем пространстве Notion.

   • Нажмите на меню «...» в правом верхнем углу.

   • Выберите «Добавить соединения».

   • Найдите и добавьте свою интеграцию

Запуск сервера

Запустите сервер в режиме разработки:

npm run dev

Или в производственном режиме:

npm start

Сервер будет работать на порту, указанном в файле .env (по умолчанию: 3000).

Конечные точки API

Обычные конечные точки HTTP

• POST /api/понятие/поиск

  • Поиск страниц в Notion

  • Тело: { "query": "search term" }

• POST /api/понятие/страница

  • Получить страницу по ID

  • Тело: { "page_id": "page-id-here" }

• POST /api/notion/база данных/запрос

  • Запрос к базе данных

  • Тело: { "database_id": "database-id-here", "filter": {}, "sorts": [] }

• POST /api/notion/страница/создать

  • Создать новую страницу

  • Тело: { "parent": {}, "properties": {}, "children": [] }

Интеграция МКП

Сервер предоставляет манифест MCP в /mcp/manifest.json , в котором описываются доступные функции.

Чтобы вызвать функцию MCP, отправьте запрос POST на /api/notion/mcp/invoke со следующей структурой:

{
  "function_name": "search_pages",
  "parameters": {
    "query": "search term"
  }
}

Доступные функции MCP

• search_pages - Поиск страниц Notion по названию или содержанию

• get_page — Получить страницу Notion по идентификатору

• query_database — запрос к базе данных Notion

• create_page — Создать новую страницу в Notion

Лицензия

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