🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
广告☁️ 云服务器特惠阿里云首购 8 折 · 腾讯云合作特惠
DeepSeek Harness Hub
← 返回列表

mingzeng21/dsh-notion

DeepSeek Harnessspec-screened扫描:低风险在 GitHub 查看 ↗
✓ 可直接安装

通过官方 Notion MCP 服务器,用 OAuth 2.0授权码 + PKCE把 DeepSeek…

自动检查通过:npm 包已发布且 engines 声明满足基线(声明 Node ^22.19.0 || >=24.0.0);该结论来自程序自动检查,未经人工实机验证。 · 最近上游提交 2026/8/30 · 已提供中文文档

将 DeepSeek Harness (dsh) 通过官方 Notion MCP 连接到 Notion —— OAuth 2.0 + PKCE,一次性登录,静默令牌刷新。

综合分
34.3
GitHub 分
34.3
用户评分
—
★ Stars
5
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add dsh-notion-mcp
npm 包 dsh-notion-mcp 已校验归属本仓库,走 npm 安装最省事
信任档位:已验证本站已于 4 天前真实安装成功(L4 · 真实安装)
是什么
dsh 原生插件 · other
装得上吗
本站已真实安装成功(L4 · 真实安装,非静态推断)
安全吗
本站尚未对该插件做风险分级(暂未覆盖,不等同于无风险)
还在维护吗
活跃:最近一次提交在 26 天前

档位由下列信号合成:本站实装验证(真实安装,当前最高到 L4)· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →

🟢实装验证通过· 2026/9/22
由本站实装验证器在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/20(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查✓ 自动检查通过

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-notion-mcp @ 0.1.0
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/20 18:47:07

依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-cmdline@deepseek-ai/dsh-credentials@deepseek-ai/dsh-mcp-client@deepseek-ai/schemastery
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

由 DeepSeek 最新模型翻译生成
dsh-notion-mcp

通过官方 Notion MCP 服务器,用 OAuth 2.0(授权码 + PKCE)把 DeepSeek Harness(dsh)连接到 Notion。完成一次性浏览器授权后,你的 dsh agent 就能通过标准的 mcp__notion__ 工具搜索、读取和写入 Notion 的页面、数据库与评论。

License: MIT Node: 22.19%2B%20or%2024%2B Awesome DSH Plugin

它能帮你做什么

装上 dsh-notion-mcp 后,你的 dsh agent 即可直接读写 Notion。你只需要在浏览器里完成一次授权,剩下的事插件都会自动打理:跑完整套 OAuth 2.0(授权码 + PKCE)流程、把 token 安全保存到 dsh 的凭据层、在后台静默刷新保持有效,并把 Notion 的搜索、页面、数据库、评论等工具以 mcp__notion__ 的形式挂载给 agent。

特性

- 零配置 OAuth —— 动态客户端注册(RFC 7591)在运行时注册客户端,无需复制任何 client_id 或密钥。
- 一次性浏览器登录 —— dsh notion login 打印授权 URL,并在 127.0.0.1:53007 等待回调。
- 静默刷新 token —— access token(约 8 小时)到期前自动刷新;轮换后的 refresh token 原子落盘。
- invalid_grant 终态处理 —— 过期或已被轮换作废的 refresh token 绝不重试;插件会清掉它并提示你重新授权。
- 仓库不含任何密钥 —— token 存在 dsh 的凭据存储里,不进入本仓库。

截图

让 dsh agent 总结一段技术架构并写入 Notion:

dsh 里请求写入 Notion

写好的 Notion 页面:

写入后的 Notion 页面

工作原理

dsh notion login
│  1. OAuth 发现(RFC 9470 / RFC 8414)
│  2. 动态客户端注册(RFC 7591)
│  3. PKCE S256 + state → 授权 URL
▼
浏览器批准 → 回调到 127.0.0.1:53007
│  4. 用 code(加 PKCE verifier)换取 token
▼
token 落盘 → Notion MCP 挂载为 mcp__notion__*

启动时插件会读取已存 token 并挂载 MCP 客户端;临近过期时在后台刷新(串行化,避免并发重放已轮换的 refresh token)。

安装

dsh plugin --profile web add dsh-notion-mcp

把 web 换成你运行 agent 所用的 profile(web、headless、tui 等)。

授权

notion 命令需要在一个「最小 profile」里运行——像 web 这类 UI app 会独占自己的命令行,不会把 notion 转发给插件。token 是全局存储的,所以在任意最小 profile 里授权一次,所有安装了本插件的 profile 都能直接使用:

dsh plugin --profile notion add dsh-notion-mcp
dsh --profile notion notion login

该命令会注册一个动态 OAuth 客户端,在 127.0.0.1:53007 起一个临时本地 HTTP 服务,并打印授权 URL。在浏览器里打开并批准后,Notion 会重定向到 http://127.0.0.1:53007/callback,插件校验 state、用 code(加 PKCE verifier)换取 token、落盘并挂载客户端。

授权完成后,Notion 工具即以 mcp__notion__* 形式可用。

卸载

dsh plugin --profile web remove dsh-notion-mcp

配置

| 键 | 默认值 | 说明 |
| --- | --- | --- |
| mcpUrl | https://mcp.notion.com/mcp | Notion MCP 服务器 URL |
| port | 53007 | 本地 OAuth 回调端口(127.0.0.1) |

安全性

- token 通过 dsh 的凭据层(ctx.credentials)以单条原子记录存储,绝不提交到本仓库;也不嵌入任何 client_id 或密钥——客户端在运行时通过动态客户端注册。
- Notion 每次刷新都会轮换 refresh token;新 token 与 access token 一起原子落盘。
- 若 Notion 返回 invalid_grant(refresh token 过期或被轮换作废),插件会清掉已存 token 并停止重试——用 dsh notion login 重新授权即可。

环境要求

- DeepSeek Harness(dsh)—— 已验证兼容 v0.1.0-rc.8、v0.1.1-rc.1、v0.1.1-rc.2、v0.1.2-alpha.1
- Node.js ^22.19.0 或 >=24.0.0(与 dsh v0.1.2-alpha.1 一致;Node 23 不在支持范围内)

开发

npm install
npm run build      # tsdown → lib/
npm run typecheck  # tsc --noEmit
npm test           # vitest

许可证

MIT © 2026 mingzeng

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

同作者(mingzeng21)的其他插件

💬 加入社群

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

DPharness QQ 群二维码,QQ 扫码进群
QQ 扫码进群
DPharness 飞书群二维码,飞书扫码进群
飞书扫码进群