mingzeng21/dsh-notion

README 摘要

dsh-notion-mcp 通过官方 Notion MCP 服务器，用 OAuth 2.0（授权码 + PKCE）把 DeepSeek Harness（ dsh ）连接到 Notion。完成一次性浏览器授权后，你的 dsh agent 就能通过标准的 mcp notion 工具搜索、读取和写入 Notion 的页面、数据库与评论。 中文 English 它能帮你做什么 装上 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 的凭据存储里，不进入本仓库。 工作原理 启动时插件会读取已存 token 并挂载 MCP 客户端；临近过期时在后台刷新（串行化，避免并发重放已轮换的 refresh token）。 安装 把 web 换成你运行 agent 所用的 profile（ web 、 headless 、 tui 等）。 授权 notion 命令需要在一个「最小 profile」里运行——像 web 这类 UI app 会独占自己的命令行，不会把 notion 转发给插件。token 是全局存储的，所以在任意最小 profile 里授权一次，所有安装了本插件的 profile 都能直接使用： 该命令会注册一个动态 OAuth 客户端，在 127.0.0.1:53007 起一个临时本地 HTTP 服务，并打印授权 URL。在浏览器里打开并批准后，Notion 会重定向到 http://127.0.0.1:53007/callback ，插件校验 state 、用 code（加 PKCE verifier）换取 token、落盘并挂载客户端。 授权完成后，Notion 工具即以 mcp notion 形式可用。 卸载 配置 键 默认值 说明 mcpUrl …

分类