Notion ReadOnly MCP Server

Notion ReadOnly MCP Server

site icon
2025.04.30 2
TypeScriptNotion APIAI助手优化只读服务内容生成开发效率
Notion ReadOnly MCP Server 是一个专为AI助手优化的只读Notion API服务,专注于高效查询和检索Notion内容。其核心功能包括只读设计、最小化工具集、并行处理、扩展数据库访问以及针对AI助手的优化。适用于需要安全访问Notion内容并进行高效数据检索的场景,特别是AI助手如Cursor和Claude等。
View on GitHub

Overview

基本能力

产品定位

Notion ReadOnly MCP Server 是一个专为AI助手优化的只读Notion API服务,专注于高效查询和检索Notion内容。

核心功能

  • 只读设计:专注于数据检索操作,确保对Notion内容的安全访问。
  • 最小化工具集:将Notion API工具从15+减少到仅6个用于文档分析的基本工具。
  • 并行处理:通过异步和并行API请求检索块内容,显著减少响应时间。
  • 扩展数据库访问:支持数据库、页面属性和评论检索操作。
  • 针对AI助手的优化:减少工具数量,解决AI助手中“工具过多可能降低性能”的问题。

适用场景

  • AI助手需要安全访问Notion内容并进行高效数据检索的场景。
  • 需要快速获取Notion页面、数据库、评论和属性信息的场景。
  • 在AI助手如Cursor和Claude等中集成Notion内容的场景。

工具列表

  • API-retrieve-a-page:获取页面信息。
  • API-get-block-children:获取页面内容块(并行处理)。
  • API-retrieve-a-block:获取特定块的详细信息。
  • API-retrieve-a-database:获取数据库信息。
  • API-retrieve-a-comment:获取页面或块的评论。
  • API-retrieve-a-page-property:获取页面的特定属性信息。
  • API-get-one-pager:递归检索完整的Notion页面及其所有块、数据库和相关内容。

常见问题解答

  • 安全性:虽然只读操作风险较低,但仍建议配置集成的“能力”以进一步限制访问。
  • 性能优化:通过减少工具数量和并行处理,显著提高响应速度和性能。
  • AI助手兼容性:减少工具数量有助于在AI助手中保持高性能和准确性。

使用教程

使用依赖

  1. 在Notion中设置集成:访问https://www.notion.so/profile/integrations,创建或选择现有的内部集成。
  2. 配置集成的“能力”为“只读内容”以增强安全性。

安装教程

使用npm

.cursor/mcp.jsonclaude_desktop_config.json中添加以下配置:

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "notion-readonly-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

使用Docker

.cursor/mcp.jsonclaude_desktop_config.json中添加以下配置:

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENAPI_MCP_HEADERS",
        "taewoong1378/notion-readonly-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

调试方式

  1. 构建:pnpm build
  2. 执行:pnpm dev

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。