Notion MCP Server

這是一個 Model Context Protocol (MCP) 伺服器，用於連接和操作 Notion API。它提供了一套完整的工具來讀取、寫入和管理 Notion 頁面與資料庫。

功能特色

• 🔍 搜尋頁面 - 在 Notion 工作區中搜尋頁面

• 📄 頁面操作 - 取得、建立和更新 Notion 頁面

• 🗃️ 資料庫查詢 - 查詢和操作 Notion 資料庫

• 📋 內容管理 - 讀取和修改頁面內容區塊

• 🔄 即時同步 - 透過 MCP 協議即時與 Notion 同步

Related MCP server: Notion MCP Server

安裝和設定

1. 安裝依賴

npm install

2. 設定 Notion 整合

1. 前往 Notion 整合設定頁面

2. 建立新的整合

3. 複製整合 token

4. 建立 .env 檔案並加入您的 token：

cp .env.example .env
# 編輯 .env 檔案，加入您的 Notion token

3. 建立專案

npm run build

使用方法

開發模式

npm run dev

生產模式

npm start

監控模式（自動重新載入）

npm run watch

可用的工具

頁面操作

• get-page - 根據 ID 取得頁面詳細資訊

• search-pages - 搜尋頁面

• create-page - 建立新頁面

• update-page - 更新頁面屬性

資料庫操作

• query-database - 查詢資料庫內容

資源

• notion://recent-pages - 最近存取的頁面

• notion://databases - 可存取的資料庫清單

在 VS Code 中使用

1. 確保已安裝 MCP 相關的 VS Code 擴充功能

2. 使用 .vscode/mcp.json 配置檔案來設定伺服器連接

3. 在 VS Code 中啟動偵錯模式以測試 MCP 伺服器

API 範例

搜尋頁面

{
  "name": "search-pages",
  "arguments": {
    "query": "meeting notes",
    "filter": {
      "property": "Status",
      "value": "Active"
    }
  }
}

建立頁面

{
  "name": "create-page",
  "arguments": {
    "parent": {
      "database_id": "your-database-id"
    },
    "properties": {
      "Name": {
        "title": [
          {
            "text": {
              "content": "新頁面標題"
            }
          }
        ]
      }
    }
  }
}

錯誤排除

常見問題

1. Authentication Error: 確認 NOTION_TOKEN 環境變數已正確設定

2. Permission Error: 確認 Notion 整合有適當的權限存取所需的頁面和資料庫

3. Module Resolution Error: 確認所有依賴已正確安裝

偵錯

在開發模式下，伺服器會在 stderr 輸出詳細的偵錯資訊。

專案結構

.
├── src/
│   ├── index.ts           # MCP 伺服器主程式
│   └── notion-service.ts  # Notion API 服務類別
├── .vscode/
│   └── mcp.json          # VS Code MCP 配置
├── .github/
│   └── copilot-instructions.md  # GitHub Copilot 指令
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

授權

MIT License

相關連結

• Model Context Protocol 官方文件

• Notion API 文件

• MCP SDK