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

基于Markdown的Notion导航MCP，只需一个ROOT_PAGE变量即可，无需使用token。

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

这是一个用于管理和与基于Notion的笔记进行交互的Model Context Protocol (MCP)服务器。这个基于TypeScript的服务器通过整合资源、工具和提示来高效地与Notion页面进行交互，以此展示MCP的概念。

功能

资源

<img width="768" alt="资源检查" src="image/resources.png">

• 访问笔记：以note://URI形式列出和检索Notion页面，带有UUID片段。
• 元数据：每个资源包括标题、描述和Markdown格式的内容。
• MIME类型：内容可以以text/markdown格式访问。

工具

<img width="768" alt="工具检查" src="image/tools.png">

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

提示

<img width="768" alt="提示检查" src="image/prompts.png">

• 总结笔记：为单个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替换为适当的文件夹路径。