Browse your entire Notion workspace, not just one database

浏览整个 Notion 工作区，而不仅仅是一个数据库

基于 Markdown 的 Notion 导航 MCP，只需设置一个 ROOT_PAGE 变量，无需令牌。

• Notion MCP 服务：notion-texonom
• Notion 页面会转换为 text/markdown mimeType 笔记。
• 根据图距离搜索和检索相关页面，同时考虑父子关系和引用关系。

用于管理和交互 Notion 笔记的模型上下文协议（MCP）服务。这个基于 TypeScript 的服务通过集成资源、工具和提示词，高效地与 Notion 页面进行交互，展示 MCP 概念。

功能

资源

• 访问笔记：以带有 UUID slug 的 note:// URI 列出并检索 Notion 页面。
• 元数据：每个资源都包含标题、描述和 Markdown 格式的内容。
• Mime 类型：内容以 text/markdown 格式提供。

工具

• 搜索笔记：使用 search_notes 工具，通过查询字符串搜索 Notion 页面。
  • 输入：用于筛选相关页面的查询文本。
  • 输出：匹配笔记的 Markdown 内容。

提示词

• 总结笔记：为单个 Notion 页面生成摘要。
  • 可用提示词：
    • summarize_note：根据 URI 总结特定笔记。
    • suggest_refactor：提出结构改进建议。
    • suggest_fix：找出笔记内容中可能需要修正之处。
    • suggest_enhance：提出改进笔记的建议。
  • 输入：Notion 页面 URI。
  • 输出：用于总结和改进的结构化消息。

开发

设置

安装依赖项：

pnpm install

构建项目：

pnpm build

开发时启用自动重新构建：

pnpm watch

配置

配置 Notion 服务：

• 设置环境变量：
  • ROOT_PAGE：Notion 工作区的根页面 ID。

在 Claude Desktop 中安装

要将此服务与 Claude Desktop 配合使用，请添加以下配置：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

配置示例：

{
  "mcpServers": {
    "notion-texonom": {
      "command": "node",
      "args": [
        "/path/to/mcp/build/index.js"
      ],
      "env": {
        "ROOT_PAGE": "$SOME_UUID"
      }
    }
  }
}

调试

要排查和调试 MCP 服务，请使用 MCP Inspector。运行以下命令启动 Inspector：

pnpm inspector

Inspector 提供基于浏览器的界面，用于检查基于 stdio 的服务通信。

关键技术

• Notion 集成：由 @texonom/nclient 和 @texonom/cli. 提供支持。
• MCP SDK：通过 @modelcontextprotocol/sdk 实现服务端操作。

远程部署

该服务现使用 SSEServerTransport 进行远程通信，从而支持共享使用。请确保已安装必要的依赖项，并正确配置服务以进行远程部署。

使用说明

要使用 SSEServerTransport 运行服务，请使用以下命令：

npx -y supergateway --port 8000 --stdio "npx -y @modelcontextprotocol/server-filesystem /some/folder"

请务必将 /some/folder 替换为相应的文件夹路径。