Skip to content

dsh-plugin-scys-mcp

Verified

dsh-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 冲突。

首次授权

插件启动时若没有有效令牌,会自动打开浏览器:

  1. 浏览器跳到 https://mcp.scys.com/mcp-oauth/authorize?...
  2. 用你的生财有术账号登录并同意授权
  3. 页面显示“授权成功”,回到 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 前检查

  1. 包名:如果 dsh-plugin-scys-mcp 已被占用,改用 scope,例如 @yourname/dsh-plugin-scys-mcp。
  2. 同步 patch 里的 name:cordis.patch.yml 的 name: 必须和 package.json 的 name 完全一致,否则安装后加载不到插件。
  3. npm pack 检查内容(应为 lib/*.js + cordis.patch.yml + README.md + package.json)。
  4. npm publish(scoped 包加 --access public,仓库里已声明 publishConfig.access)。

装好后的启用路径是 Plugins 页面 / plugin_manager.installBundle(它会写 dsh.profile.bundles); 只跑 dsh plugin --profile desktop add 只是 pnpm 安装,不会自动启用该 bundle。