Notion ReadOnly

🚀 僅讀取的Notion MCP服務器

本項目打造了一個專為性能與效率優化的僅讀Notion API MCP服務器，主要用於為AI助手查詢和檢索Notion中的內容。

🚀 快速開始

此項目實現的僅讀Notion API MCP服務器，專注於為AI助手提供Notion內容的查詢與檢索服務。您可按以下步驟進行操作。

✨ 主要特性

• 僅讀設計：專注於數據檢索操作，保障安全訪問Notion內容。
• 最小化工具集：將暴露的Notion API工具數量從15+縮減至僅6個基本功能，用於文檔分析。
• 並行處理：通過實現異步和並行API請求提升性能，顯著縮短響應時間，尤其在檢索塊內容時效果顯著。
• 擴展數據庫訪問：增加了對數據庫、頁面屬性和評論檢索操作的支持。
• 優化AI助手：大幅減少工具數量，解決了Cursor等AI助手中“工具過多會降低性能”的問題，這些模型通常限制約40個工具。

📦 安裝指南

1. 在Notion中設置集成

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

⚠️ 重要提示

雖然我們將Notion API的範圍限制為僅讀操作，但將工作區數據暴露給大語言模型（LLM）存在一定風險。注重安全的用戶可進一步配置集成的_功能_。例如，您可在“配置”選項卡中只授予“讀取內容”訪問權限。

2. 安裝依賴項

使用以下命令安裝所需的依賴項：

pnpm install

📚 詳細文檔

工具對比

與標準Notion API集成相比，此僅讀實現暴露的工具數量大幅減少，從而提升了AI助手的性能： 減少的工具集有助於保持在推薦的工具限制內，以實現優化的AI助手性能，同時仍提供所有基本功能。

配置

根據需要調整以下位於config.ts文件中的配置參數：

// 網絡請求超時時間（秒）
export const TIMEOUT = 30;

// 是否啟用調試日誌
export const DEBUG = false;

// 默認頁面大小
export const DEFAULT_PAGE_SIZE = 100;

開發

• 構建：

pnpm build

• 運行：

pnpm dev

對AI助手性能的好處

現代AI助手如Cursor和Claude在工具數量上有一定限制：

• 大多數模型可能不支持超過40個工具。
• 工具過多會降低整體性能和推理能力。
• 複雜的工具集會增加響應延遲並增加決策難度。

此僅讀實現通過簡化Notion API表面來解決這些問題，同時保留所有基本功能。結果是：

• AI助手響應更快、更可靠。
• 與Notion內容交互時準確性更高。
• 通過專注於API設計實現更好的整體性能。

📄 許可證

本項目採用MIT許可證。