Akirapapa MCP Notion Server

🚀 Notion MCP 服務器

Notion MCP 服務器藉助 Notion API 實現了 MCP（機器學習控制平面），它能讓 Claude 與 Notion 工作區進行交互，為用戶帶來更便捷的操作體驗。

✨ 主要特性

該服務器提供了一系列工具，可對 Notion 中的塊、頁面和數據庫進行操作，具體如下：

1. notion_append_block_children：向父塊追加子塊。
   • 必填輸入：
     • block_id (字符串)：父塊的 ID。
     • children (數組)：要追加的塊對象數組。
   • 返回：關於已添加塊的信息。
2. notion_retrieve_block：獲取特定塊的詳細信息。
   • 必填輸入：
     • block_id (字符串)：要獲取的塊 ID。
   • 返回：關於該塊的詳細信息。
3. notion_retrieve_block_children：獲取特定塊的子塊。
   • 必填輸入：
     • block_id (字符串)：父塊的 ID。
   • 可選輸入：
     • start_cursor (字符串)：下一頁結果的遊標。
     • page_size (數字，默認值：100，最大值：100)：要獲取的塊數量。
   • 返回：子塊列表。
4. notion_delete_block：刪除特定塊。
   • 必填輸入：
     • block_id (字符串)：要刪除的塊 ID。
   • 返回：確認已刪除的信息。
5. notion_retrieve_page：獲取特定頁面的詳細信息。
   • 必填輸入：
     • page_id (字符串)：要獲取的頁面 ID。
   • 返回：關於該頁面的詳細信息。
6. notion_update_page_properties：更新頁面屬性。
   • 必填輸入：
     • page_id (字符串)：要更新的頁面 ID。
     • properties (對象)：要更新的屬性。
   • 返回：關於已更新頁面的信息。
7. notion_create_database：創建新的數據庫。
   • 必填輸入：
     • parent (對象)：數據庫的父對象。
     • title (數組)：數據庫的標題（富文本數組）。
     • properties (對象)：數據庫屬性。
   • 返回：新創建的數據庫。
8. notion_delete_database：刪除特定數據庫。
   • 必填輸入：
     • database_id (字符串)：要刪除的數據庫 ID。
   • 返回：確認已刪除的信息。
9. notion_retrieve_databases：獲取所有數據庫列表。
   • 返回：數據庫列表。
10. notion_query_database：查詢特定數據庫的內容。
    • 必填輸入：
      • database_id (字符串)：要查詢的數據庫 ID。
      • query (對象)：查詢參數。
    • 返回：數據庫查詢結果。
11. notion_create_page：創建新頁面。
    • 必填輸入：
      • parent (對象)：頁面的父對象。
      • properties (對象)：頁面屬性。
      • children (數組)：初始子塊。
    • 返回：新創建的頁面。

📦 安裝指南

若要在 Notion 中配置 MCP 服務器，請按照以下步驟操作：

1. 創建 Notion 集成：在 Notion 中創建一個新的集成，確保啟用所需的權限（如“讀取和寫入”）。
2. 獲取集成令牌：創建完成後，複製集成的令牌（也稱為 API 令牌），這將是後續配置的關鍵。
3. 將集成連接到工作區：
   • 打開 Notion 中的相關頁面或數據庫。
   • 點擊右上角導航欄中的按鈕。
   • 點擊“連接到”按鈕並選擇您的集成。
4. 配置 Claude Desktop：在 claude_desktop_config.json 文件中添加以下內容：

{
    "mcpServers": {
        "notion": {
            "command": "node",
            "args": ["your-built-file-path"],
            "env": {
                "NOTION_API_TOKEN": "your-integration-token"
            }
        }
    }
}

🚧 故障排除

如果遇到權限錯誤，請執行以下步驟：

1. 確保集成具有所需的權限。
2. 驗證集成是否已受邀加入相關頁面或數據庫。
3. 確認令牌和配置在 claude_desktop_config.json 中正確設置。

📄 許可證

此 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參閱項目倉庫中的 LICENSE 文件。