@dsh-so/mcp

English | 简体中文

dsh.so 的 MCP（Model Context Protocol）服务器：把站点预渲染的机器可读插件数据（注册表索引、安全扫描、L1-L5 安装实测、npm 周下载榜、Star 涨幅榜）以结构化工具的形式暴露给 Agent。

零依赖、纯读取 —— 每个工具只是抓取对应的静态 JSON 端点并裁剪返回，与站点「无后端、免密钥、CORS 全开」的架构完全一致。

接入

在任意支持 MCP 的客户端（Claude Code / ZCode / Cursor 等）配置：

{
  "mcpServers": {
    "dsh-so": {
      "command": "npx",
      "args": ["-y", "@dsh-so/mcp"]
    }
  }
}

环境变量 DSH_SO_BASE 可覆盖数据源（默认 https://www.dsh.so）。

工具

| 工具 | 数据源 | 说明 | | --- | --- | --- | | search_plugins | /plugins-index.json | 关键词 + 验证等级 / 安全状态 / 风险等级过滤，默认排除生态应用 | | get_plugin_record | /plugin/<id>.json | 单插件权威事实表（推荐/安装前先查这个） | | get_security_scan | /artifact/<id>.json | 单插件安全扫描记录（verdict / findings / 版本绑定） | | get_install_status | /data/install/<id>.json | 单插件安装实测状态（L5 优先 / L4 兜底） | | get_npm_downloads | /data/npm-downloads.json | npm 周下载 Top-100 榜 | | get_star_trend | /data/star-trend.json | 一周 Star 涨幅 Top-100 榜 | | data_freshness | 多端点 | 各核心数据源的新鲜度标记（generatedAt / snapshotDate） |

端点完整语义见 https://www.dsh.so/data/。

Agent Skill

本包自带 SKILL.md（dsh-plugin-data），教 Agent 在推荐 / 安装 DSH 插件前先核验安全与安装状态。不配 MCP、只用 skill 也行 —— skill 会指引 Agent 直接 fetch 静态端点。站内直链：https://www.dsh.so/skills/dsh-plugin-data/SKILL.md。

许可

代码 MIT；数据 CC BY 4.0 —— 转发必须保留 generatedAt / asOf / checkedAt 新鲜度标记并署名 dsh.so。