dsh-plugin-scys-mcp
Verifieddsh-plugin-scys-mcp · v0.1.2 · MIT
生财有术 MCP(scys.com)for DeepSeek Harness — OAuth 2.1 网页授权,原生工具注册,macOS / Windows / Linux
Install
dsh plugin add dsh-plugin-scys-mcp Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Creators
Readme
dsh-plugin-scys-mcp
生财有术(scys.com)MCP 的 DeepSeek Harness 插件。装好后打开浏览器授权一次,就把 160 个站内工具接进 Harness:
mcp__scys-mcp__searchTopic 搜帖子
mcp__scys-mcp__getDailyReport 生财日报
mcp__scys-mcp__getMyInsight 我的画像
mcp__scys-mcp__getUserInsight 用户画像
...
不需要本地代理、不需要手工改配置、不需要额外进程;macOS / Windows / Linux 行为一致。 连接中断时插件会自动重建传输并重试一次当前调用,已注册的工具不会消失。
为什么需要插件
DSH 自带的 dsh-mcp-client 只支持静态 headers,而 scys MCP 要求 OAuth 2.1(PKCE + 动态客户端注册)。本插件在 Harness 进程内完成授权并把令牌注入每个请求,因此不需要旁路进程。
安装
# 从 npm(发布后)
dsh plugin --profile desktop add dsh-plugin-scys-mcp
# 或从本地目录 / tarball
dsh plugin --profile desktop add file:/path/to/dsh-plugin-scys-mcp
也可以在 Web 侧边栏 Plugins 页搜索安装。安装后插件自带一行配置:
- insert:
- id: mcp-scys-oauth
name: 'dsh-plugin-scys-mcp'
config:
serverName: scys-mcp
如果你之前手工加过
mcp-scys/mcp-scys-oauth行,先删掉,避免同serverName冲突。
首次授权
插件启动时若没有有效令牌,会自动打开浏览器:
- 浏览器跳到
https://mcp.scys.com/mcp-oauth/authorize?... - 用你的生财有术账号登录并同意授权
- 页面显示“授权成功”,回到 Harness —— 工具会在几秒内出现
授权窗口最长等待 15 分钟。如果错过了,跟模型说一句“重新授权生财 MCP”,或直接调用 mcp__scys-mcp__auth,会重新打开授权页。
令牌
| 项 | 说明 |
|---|---|
| access token | 1 小时,到期前 60 秒自动刷新 |
| refresh token | 每次刷新都会轮换,14 天窗口随之顺延 |
| 存储位置 | ~/.dsh/mcp/scys-mcp/tokens.json(Windows: %USERPROFILE%\.dsh\mcp\scys-mcp\) |
| 客户端注册 | client.json(动态注册的 public client,绑定 http://127.0.0.1:<port>/callback) |
令牌只在本地,插件直接访问 mcp.scys.com,不经过任何第三方。
配置项
| 字段 | 默认值 | 说明 |
|---|---|---|
serverName |
scys-mcp |
工具前缀,[A-Za-z0-9_-]{1,32} |
url |
https://mcp.scys.com/shengcai-web/mcp |
MCP 端点 |
port |
18787 |
授权回调端口,占用时自动换空闲端口 |
openBrowser |
true |
授权时是否自动打开浏览器 |
toolCallTimeoutMs |
120000 |
单次工具调用超时 |
authorizeTimeoutMs |
900000 |
授权等待上限 |
故障排查
看 ~/.dsh/mcp/scys-mcp/plugin.log:
registered N/M tools—— 正常,N 应接近 160。register <tool> failed—— 某个工具的 schema 超出 Harness 支持的子集,会被跳过,不影响其他工具。授权已失效—— 重新授权:调用mcp__scys-mcp__auth。- 端口被占 —— 自动改用空闲端口,无需处理。
卸载
dsh plugin --profile desktop remove dsh-plugin-scys-mcp
rm -rf ~/.dsh/mcp/scys-mcp # 同时清除本地令牌
平台说明
- macOS:
open打开默认浏览器;无需任何系统权限。 - Windows:
rundll32 url.dll,FileProtocolHandler打开默认浏览器(不经cmd.exe,URL 里的&不会被当成命令分隔符);回调只监听127.0.0.1,不会触发防火墙弹窗。 - Linux:
xdg-open。
开发
node scripts/selftest.mjs # 用已存令牌跑 initialize / tools/list / tools/call
node scripts/plugin-test.mjs # 全链路离线测试:模拟 AS + MCP,验证授权、注册、断线重连
源码结构:
| 文件 | 作用 |
|---|---|
lib/index.js |
插件入口:连接、工具注册、auth 工具 |
lib/oauth.js |
OAuth 2.1:发现、DCR、PKCE、刷新、回环回调 |
lib/mcp.js |
Streamable HTTP 上的 JSON-RPC 客户端(JSON + SSE) |
lib/store.js |
本地令牌与客户端注册存储 |
scripts/plugin-test.mjs |
零网络的端到端测试(mock OAuth + mock MCP) |
零运行时依赖,只用 Node 内置模块与全局 fetch。
发布到 npm 前检查
- 包名:如果
dsh-plugin-scys-mcp已被占用,改用 scope,例如@yourname/dsh-plugin-scys-mcp。 - 同步 patch 里的 name:
cordis.patch.yml的name:必须和 package.json 的name完全一致,否则安装后加载不到插件。 npm pack检查内容(应为lib/*.js+cordis.patch.yml+README.md+package.json)。npm publish(scoped 包加--access public,仓库里已声明publishConfig.access)。
装好后的启用路径是 Plugins 页面 / plugin_manager.installBundle(它会写 dsh.profile.bundles);
只跑 dsh plugin --profile desktop add 只是 pnpm 安装,不会自动启用该 bundle。