mcpField
N
notion-export-mcp-server

notion-export-mcp-server

本地服务
npmjs.com记忆与知识181 周前更新
代码仓库访问官网

关于 notion-export-mcp-server

notion-export-mcp-server 通过 MCP 服务开放 Notion 的非官方导出 API，让 AI 客户端以 Markdown 获取页面导出内容。它适用于需要从兼容 MCP 的工具访问 Notion 页面导出的用户；其运行依赖可能发生变化的 Notion 内部 API。

主要功能

  1. 01以 Markdown 获取导出结果
  2. 02访问 Notion 非官方 API
  3. 03使用 Notion 令牌进行身份验证

适用场景

  1. 01在 AI 客户端中获取 Notion 页面导出内容
  2. 02以 Markdown 读取页面导出结果
  3. 03让 MCP 客户端连接 Notion 导出数据

MCP 相关

该服务提供 `notion_export_get_result` 工具，以 Markdown 文本返回 Notion 导出结果。MCP 客户端可通过服务配置连接。

#mcp#notion#modelcontextprotocol

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "notion-export": {
      "command": "npx",
      "args": [
        "-y",
        "notion-export-mcp-server"
      ]
    }
  }
}
启动命令npx -y notion-export-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmnotion-export-mcp-server

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

notion-export-mcp-server

npm version

一个 MCP（模型上下文协议） 服务，可通过 Notion 的非官方 API 导出页面。

此服务通过标准化接口提供与 MCP 兼容的 Notion 非官方 API 访问方式，让 AI 助手能够与导出的 Notion 页面数据交互。

功能

可用工具：

  • notion_export_get_result - 获取 Notion 导出结果的 Markdown 文本

快速开始

安装
手动安装
npm install notion-export-mcp-server
配置
  • NOTION_TOKEN_V2：你的 Notion 令牌
  • NOTION_FILE_TOKEN：你的 Notion 文件令牌
使用方法
启动 MCP 服务

直接运行：

npx notion-export-mcp-server

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

编辑客户端的 MCP 配置 JSON：
...
    "notion-export": {
      "command": "npx",
      "args": [
        "-y",
        "notion-export-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN_V2": "<your token>",
        "NOTION_FILE_TOKEN": "<your token>"
      }
    },
...

密钥？

如何获取

要从 Notion 导出内容，需要通过一些 Cookie 进行身份验证（就像浏览器一样）。这些 Cookie 名为 token_v2 和 file_token。使用 Notion 网页应用时，它们会随已登录用户的所有请求一起发送。

  1. 前往 notion.so。
  2. 使用你的账号登录。
  3. 打开浏览器开发者工具，进入 Application > Storage > Cookies（Chrome）；Storage 标签页（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 - 运行代码检查（ESLint 和 Prettier）
  • npm run fix - 自动修复代码检查问题
  • npm run examples - 运行示例脚本
贡献
  1. Fork 此代码库
  2. 创建你的功能分支
  3. 运行测试和代码检查：npm run lint
  4. 提交你的更改
  5. 推送到该分支
  6. 创建 Pull Request

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。