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

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

• Notion MCP 服务器: notion-texonom
• Notion 页面被转换为 text/markdown mimeType 的笔记。
• 基于图距离搜索和检索相关页面，考虑父子关系和引用关系。

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

功能

资源

<img width="768" alt="Resources Inspection" src="image/resources.png">

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

工具

<img width="768" alt="Tools Inspection" src="image/tools.png">

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

提示

<img width="768" alt="Prompts Inspection" 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 替换为您的文件夹的相应路径。