Notion MCP Server (Official)

🚀 Notion MCP 服務器

本項目實現了一個用於 Notion API 的 MCP 服務器，藉助該服務器，用戶能夠更便捷地與 Notion API 進行交互，拓展 Notion 的使用場景。

🚀 快速開始

按照以下步驟，你可以快速搭建並使用 Notion MCP 服務器。

📦 安裝指南

1. 在 Notion 中設置集成

訪問 https://www.notion.so/profile/integrations 並創建一個新的 內部 集成，或選擇一個現有的集成。

儘管我們限制了 Notion API 的暴露範圍（例如，您無法通過 MCP 刪除數據庫），但將數據暴露給 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", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

使用 Docker

有兩種方法可以使用 Docker 運行 MCP 服務器：

方法 1：使用官方 Docker 鏡像

在 docker-compose.yml 中添加以下內容以啟動 MCP 服務器：

version: '3'
services:
  notion-mcp-server:
    image: ghcr.io/notionhq/notion-mcp-server:latest
    ports:
      - "19000:19000"

然後運行：

docker-compose up --build

方法 2：本地構建並運行

安裝依賴項：

npm install @notionhq/notion-mcp-server --save-dev

在 package.json 中添加腳本：

{
  "scripts": {
    "mcp-server": "npx -y --prefix . @notionhq/notion-mcp-server"
  }
}

運行：

npm run mcp-server

3. 將內容連接到集成

在 Notion 中，導航到您要連接的內容（頁面或數據庫），然後使用側邊欄中的“設置”菜單將該內容連接到之前創建的集成。

💻 使用示例

基礎用法

1. 添加評論

post http://localhost:19000/comments
Content-Type: application/json

{
  "parent": "page_id",
  "content": "這是一個測試評論。"
}

2. 獲取頁面內容

get http://localhost:19000/page_content?page_id=page_id

3. 搜索內容

post http://localhost:19000/search
Content-Type: application/json

{
  "query": "要搜索的內容"
}

🔧 技術細節

構建

npm run build

運行

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

發佈

npm publish --access public