Notion导出服务

一个通过MCP协议访问Notion非官方API的服务器,用于导出Notion页面内容。

  • by syucream
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 syucream/notion-export-mcp-server

使用说明

概念导出mcp服务器

A. MCP(模型上下文协议) 访问的服务器 概念 用于导出页面的非官方API。

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

特性

可用工具:

  • notion_export_get_result -获取概念导出结果标记文本

快速开始

安装

手动安装

npm install notion-export-mcp-server

配置

  • NOTION_TOKEN_V2:您的Notion令牌
  • NOTION_FILE_TOKEN:您的Notion文件令牌

用法

启动MCP服务器

直接:

npx notion-export-mcp-server

或者,使用节点运行已安装的模块。

为您的客户端编辑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 web应用程序时,登录用户的所有请求都会设置它们。

  1. 去通知。
  2. 使用您的帐户登录。
  3. 打开浏览器的开发工具,打开应用程序>存储>Cookie(Chrome);存储选项卡(Firefox)。
  4. 复制所调用Cookie的值 token_v2 和 file_token 把它们贴在安全的地方。
    • ⚠️ 如果找不到file_token,则至少需要手动导出一次文件。
  5. 这些饼干的有效期为1年,所以你不需要经常这样做。

稳定性说明

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

发展

可用脚本

  • npm run dev -以热重新加载的开发模式启动服务器
  • npm run build -建设生产项目
  • npm run start -启动生产服务器
  • npm run lint -运行linting检查(ESLint和Prettier)
  • npm run fix -自动修复掉毛问题
  • npm run examples -运行示例脚本

贡献

  1. 分叉存储库
  2. 创建功能分支
  3. 运行测试和梳理: npm run lint
  4. 提交您的更改
  5. 推到分支
  6. 创建拉取请求