MCP Notion Server

🚀 Notion MCP 服務器

Notion MCP 服務器是一個用於與 Notion 進行交互的工具，它提供了豐富的功能，如頁面管理、數據庫交互等，方便用戶對 Notion 數據進行操作。

🚀 快速開始

安裝指南

安裝依賴

運行以下命令安裝所需的依賴項：

pip install python-dotenv requests

克隆倉庫

使用 Git 克隆此倉庫：

git clone https://github.com/your-username/notion-mcp.git
cd notion-mcp

配置

獲取配置文件

創建一個名為 config.env 的新文件，並添加以下內容：

NOTION_TOKEN=你的Notion令牌
PORT=指定的端口（默認為5000）

運行服務器

運行主腳本以啟動 MCP 服務器：

python3 mcp_server.py

注意事項

⚠️ 重要提示

• 確保你擁有有效的 Notion 令牌。
• 配置文件中的 PORT 可以根據需要進行調整。
• 確保服務器運行時網絡連接正常。
• 定期檢查依賴庫的更新，以保持最佳性能和安全性。
• 確保你擁有正確的權限來執行這些操作。
• 遵守 Notion 的 API 使用政策和限制。
• 定期檢查和更新依賴庫以保持安全性和兼容性。

✨ 主要特性

基本功能

1. 頁面管理

   • 創建新頁面
   • 更新現有頁面
   • 刪除指定頁面

2. 數據庫交互

   • 查詢數據庫項
   • 創建新數據庫項
   • 更新數據庫項
   • 刪除數據庫項

3. 用戶操作

   • 獲取當前用戶信息
   • 獲取所有用戶信息
   • 獲取當前 bot 用戶信息

4. 評論處理

   • 在頁面或塊中創建評論
   • 查詢指定頁面的評論
   • 更新或刪除評論

擴展功能

1. 批量操作

   • 批量創建頁面或數據庫項
   • 批量更新屬性
   • 批量刪除操作

2. 高級查詢

   • 複雜條件過濾
   • 排序和分頁
   • 關聯查詢（如通過數據庫關係）

3. 事件監聽

   • 監聽頁面或數據庫變化的即時事件
   • 自動觸發預設操作

4. 日誌記錄

   • 記錄所有 API 調用的日誌
   • 提供詳細的錯誤報告

💻 使用示例

基礎用法

1. 創建頁面

POST /api/create_page
Content-Type: application/json

{
  "parent": {
    "database_id": "09d4db7b-xxxx-xxxx-xxxx-c86ab25ef5cf"
  },
  "properties": {
    "Name": {
      "title": [
        {
          "text": {
            "content": "新頁面標題"
          }
        }
      ]
    }
  },
  "children": []
}

2. 更新頁面

PUT /api/update_page?id=14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd
Content-Type: application/json

{
  "properties": {
    "Name": {
      "title": [
        {
          "text": {
            "content": "更新後的頁面標題"
          }
        }
      ]
    }
  },
  "children": []
}

3. 刪除頁面

DELETE /api/delete_page?id=14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd

4. 查詢數據庫

POST /api/query_database?database_id=09d4db7b-xxxx-xxxx-xxxx-c86ab25ef5cf
Content-Type: application/json

{
  "filter": {
    "property": "Status",
    "value": {
      "status": {
        "equals": "完成"
      }
    }
  },
  "sorts": [
    {
      "property": "創建時間",
      "direction": "descending"
    }
  ],
  "start_cursor": "",
  "page_size": 10
}

5. 創建數據庫項

POST /api/create_database_item?database_id=09d4db7b-xxxx-xxxx-xxxx-c86ab25ef5cf
Content-Type: application/json

{
  "properties": {
    "Name": {
      "title": [
        {
          "text": {
            "content": "新數據庫項"
          }
        }
      ]
    },
    "Status": {
      "select": {
        "name": "完成"
      }
    }
  },
  "children": []
}

6. 獲取用戶信息

GET /api/get_user_info

7. 創建評論

POST /api/create_comment
Content-Type: application/json

{
  "parent": {
    "page_id": "14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd"
  },
  "properties": {},
  "children": [
    {
      "object": "block",
      "type": "paragraph",
      "paragraph": {
        "rich_text": [
          {
            "type": "text",
            "text": {
              "content": "這是一個新評論。"
            }
          }
        ]
      }
    }
  ]
}

8. 獲取評論

GET /api/get_comments?page_id=14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd

高級用法

由於原文檔未明確高級用法相關代碼示例，此處暫不提供。

📄 許可證

本項目遵循 MIT 協議。請查閱 LICENSE 文件獲取詳細信息。

感謝使用我們的 MCP 服務器！如有任何問題，請隨時聯繫支持團隊。