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许可证。