makenotion/notion-mcp-server

解決的問題

本專案為 AI Agent 提供了一種直接與 Notion 工作區互動的方式。它彌合了 LLM 驅動的用戶端（如 Claude Desktop、Cursor 或 Zed）與 Notion API 之間的鴻溝，允許 AI 使用標準化協定讀取、搜尋和編輯 Notion 頁面及資料庫。

工作原理

它實現了一個封裝了 Notion API 的 Model Context Protocol (MCP) 伺服器。該伺服器公開了一套 AI Agent 可以發現並呼叫的工具（目前為 22 個）。它支援兩種通訊方式：用於本地桌面用戶端的標準輸入/輸出 (STDIO) 以及用於 Web 應用程式的可串流 HTTP 傳輸。為了針對 AI 進行優化，它包含了專門的工具，將頁面內容處理為 Markdown 而非複雜的 JSON 區塊，從而減少了 Token 的使用。

適用對象

• AI Agent 使用者：希望其 AI 能夠管理 Notion 筆記和資料庫的 MCP 相容用戶端使用者。
• 開發者：正在構建需要結構化且高效利用 Token 的方式來整合 Notion 資料的 AI 應用程式開發者。

亮點

• 高效利用 Token 的 Markdown：專門用於以 Markdown 格式讀取和更新頁面內容的工具，以節省 LLM Token。
• 靈活的部署：可以透過 npm、Docker 或作為遠端伺服器執行。
• 多租戶支援：支援 Token 透傳，允許單一伺服器部署服務於多個 Notion 整合。
• 廣泛的用戶端相容性：為 Cursor、Claude Desktop、Zed 和 GitHub Copilot CLI 提供即插即用的配置。