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

基于 Markdown 的 Notion 仅使用单个ROOT_PAGE变量来导航 MCP，从而无需使用令牌。

• Notion MCP 服务器： notion-texonom

• Notion 页面被转换为text/markdown mimeType 注释。

• 根据图距离搜索和检索相关页面，考虑父子关系和引用关系。

一个模型上下文协议 (MCP) 服务器，用于管理和与基于 Notion 的笔记交互。这个基于 TypeScript 的服务器通过集成资源、工具和提示来演示 MCP 概念，以便高效地与 Notion 页面交互。

特征

资源

• 访问注释：列出并检索带有 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。

  • 输出：用于总结和增强的结构化消息。

Related MCP server: github-manager MCP Server

发展

设置

安装依赖项：

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 检查器。要启动检查器，请运行：

pnpm 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替换为文件夹的适当路径。