notion-export-mcp-server

一个访问 Notion 非官方 API 以导出页面的 MCP(模型上下文协议) 服务器。

该服务器提供与 MCP 兼容的 Notion 非官方 API 访问，允许 AI 助手通过标准化接口与您的 Notion 导出页面数据进行交互。

特性

可用工具：

• notion_export_get_result - 获取 notion 导出结果 markdown 文本

快速开始

安装

手动安装

npm install notion-export-mcp-server

配置

• NOTION_TOKEN_V2: 您的 Notion token
• NOTION_FILE_TOKEN: 您的 Notion file token

用法

启动 MCP 服务器

直接运行：

npx notion-export-mcp-server

或者，使用 node 运行已安装的模块。

编辑客户端的 MCP 配置 json：

...
    "notion-export": {
      "command": "npx",
      "args": [
        "-y",
        "notion-export-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN_V2": "<您的 token>",
        "NOTION_FILE_TOKEN": "<您的 token>"
      }
    },
...

密钥？

如何获取

要从 Notion 导出任何内容，需要使用一些 Cookie（如浏览器）进行身份验证。 这些 cookie 称为 token_v2 和 file_token。 当使用 Notion Web 应用程序时，它们会在已登录用户的所有请求上设置。

1. 前往 notion.so。
2. 使用您的帐户登录。
3. 打开浏览器的开发者工具，打开 应用程序 > 存储 > Cookie (Chrome)； 存储选项卡 (Firefox)。
4. 复制名为 token_v2 和 file_token 的 Cookie 的值，并将其粘贴到安全的地方。
   • ⚠️ 如果您找不到 file_token，您需要至少手动导出过一次文件。
5. 这些 cookie 的有效期为 1 年，因此您无需经常执行此操作。

关于稳定性的说明

此工具完全依赖于官方但内部的 Notion.so API 的导出/下载功能。 优点是，我们不自己生成任何标记，只需下载和提取一些 ZIP。 虽然下载功能似乎相当稳定，但请记住它仍然是一个内部 API，因此它可能随时中断。

开发

可用脚本

• npm run dev - 以热重载的开发模式启动服务器
• npm run build - 构建用于生产的项目
• npm run start - 启动生产服务器
• npm run lint - 运行 linting 检查（ESLint 和 Prettier）
• npm run fix - 自动修复 linting 问题
• npm run examples - 运行示例脚本

贡献

1. Fork 仓库
2. 创建您的功能分支
3. 运行测试和 linting: npm run lint
4. 提交您的更改
5. 推送到分支
6. 创建一个 Pull Request