SkillAgentSearch skills...

dsh-mcp-center

中文优先的 MCP Server 市场:Git registry + Astro 静态站 + GitHub Pages

Install / Use

claude mcp add Bai-2008 -- npx -y github:Bai-2008/dsh-mcp-center

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

68/100

Supported Platforms

Claude Code
Claude Desktop

Our assessment of dsh-mcp-center

dsh-mcp-center scores 68/100 on our quality scale, 3939th of 4,698 Development & Engineering skills we index.

Its MCP Server is 18 KB long, well organised into 27 sections with 24 code examples: a thorough specification that gives an agent plenty to work with.

It has 3 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
8/15
Adoption
3/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so dsh-mcp-center is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 87/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

dsh-mcp-center compared with similar skills

All 4 of these similar skills score higher than dsh-mcp-center; compare them before choosing.

SkillScoreStarsUpdatedFormat
dsh-mcp-center (this skill)by Bai-2008683todayMCP Server
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install dsh-mcp-center?
Run claude mcp add Bai-2008 -- npx -y github:Bai-2008/dsh-mcp-center. The install tabs above show the steps for each supported agent.
Which AI agents does dsh-mcp-center work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is dsh-mcp-center safe to use?
It is MIT-licensed and scores 87/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is dsh-mcp-center still maintained?
The repository was last updated today, so dsh-mcp-center is actively maintained.

dsh-mcp-center

一个以 Git 仓库作为数据库 的 MCP Server 市场。没有后端服务,没有外部数据库:每个条目是一个 YAML 文件,GitHub Actions 负责校验、投稿、同步与构建,GitHub Pages 负责展示。

仓库目标:

  • 用 Issue Forms 和 Pull Request 维护目录数据;
  • 用 JSON Schema 约束字段和传输方式;
  • 用 CI 生成带 verified 标记的只读索引;
  • 用官方 server.json 映射与 modelcontextprotocol/registry 生态互通;
  • 用每日同步任务维护 remote 型 MCP 的工具清单和健康状态。

当前进度

第一阶段已完成:

  • [x] 按首字母分片的 registry/ 数据层与 10 个种子条目
  • [x] schema/registry.schema.json
  • [x] scripts/validate.mjs 校验 YAML、名称查重、仓库链接与传输配置
  • [x] scripts/build-index.mjs 生成 CI 校验后的 verified 索引
  • [x] scripts/convert-to-official.mjs 映射为官方 server.json
  • [x] .github/workflows/validate.yml

第二阶段已完成:

  • [x] Issue Forms 投稿入口
  • [x] on-issue.yml 解析表单、校验、自动创建/更新 PR、失败时在 Issue 评论
  • [x] ci.yml 校验 repository 404、npm/PyPI 包存在性、打上 verified 标签
  • [x] approval-gate 强制要求维护者 approve
  • [x] sync.yml 每日抓取 remote 型 MCP 的 tools/list
  • [x] 连续 7 天失败创建 possibly-broken 追踪 Issue
  • [x] stdio 同步明确跳过,等待沙箱方案

第三阶段已完成:

  • [x] build-web.mjs 生成 index.json 与条目数据
  • [x] fetch-icons.mjs 构建时抓取 favicon,失败回退 SVG
  • [x] Astro 纯静态站点:首页 + 每条目预渲染详情页
  • [x] 原生 TS 交互:搜索弹窗、URL 筛选、安装 Tab、复制、主题切换
  • [x] 多客户端安装配置:DSH / Claude Desktop / Cursor / Cline
  • [x] 深浅色主题、SEO / JSON-LD / sitemap
  • [x] pages.yml 构建并部署 GitHub Pages

工作方式

GitHub Issue Form
      │
      ▼
on-issue.yml ──► 解析为 registry/<首字母>/<name>.yaml
      │                 │
      │                 ▼
      │            validate.mjs
      │                 │
      ▼                 ▼
失败评论 ◄──── 失败   自动创建/更新 PR
                        │
                        ▼
                     ci.yml
              validate + 上游 404/包检查
                        │
              ┌─────────┴─────────┐
              ▼                   ▼
         verified 标签       approval-gate
                                  │
                          维护者手动 approve
                                  │
                              手动合并

sync.yml(每日)
      │
      ├─ remote:initialize + tools/list
      ├─ 清单变化:PR "chore: sync tools"
      ├─ 连续失败 7 天:possibly-broken 追踪 Issue
      └─ stdio:跳过(TODO: 沙箱)

fetch-icons.mjs + build-web.mjs
      │
      ├─ web/public/icons/ + index.json
      ├─ web/src/data/index.json
      └─ Astro
            ├─ dist-site/index.html
            ├─ dist-site/servers/<slug>/index.html
            └─ pages.yml ──► GitHub Pages

校验类 workflow 不回写源 YAML。只有 sync.yml 会更新 tools、last_checked 和 sync/state.json,并通过 PR/状态提交进入 Git 历史。

目录结构

.
├── registry/                     # 按 server name 首字母分片
│   ├── c/
│   ├── f/
│   ├── g/
│   ├── m/
│   ├── o/
│   ├── p/
│   └── s/
├── schema/
│   └── registry.schema.json      # 条目 JSON Schema(Draft 2020-12)
├── scripts/
│   ├── lib/registry.mjs          # 加载、Schema 校验与语义校验
│   ├── lib/stdio-package.mjs     # npx / pnpx / uvx 包推断
│   ├── lib/install-config.mjs    # 四客户端配置生成
│   ├── lib/tool-risk.mjs         # 副作用工具识别
│   ├── fetch-icons.mjs           # favicon 抓取 + SVG 回退
│   ├── validate.mjs              # 校验入口
│   ├── build-index.mjs           # 生成 dist/registry.json
│   ├── build-web.mjs             # 生成 index.json 与页面数据
│   ├── build-dsh-plugin.mjs      # 生成原生 DSH 插件客户端(无内置目录)
│   ├── relativize-assets.mjs      # 将 HTML 根路径改写为相对路径
│   ├── convert-to-official.mjs   # 转换为官方 server.json
│   ├── issue-form-to-registry.mjs# Issue Forms -> YAML
│   ├── check-upstream.mjs        # repository 404 / npm / PyPI 检查
│   ├── sync-tools.mjs            # remote MCP tools/list 同步
│   └── sync-health.mjs           # 7 天失败追踪 Issue
├── sync/
│   └── state.json                # 同步失败计数与最近状态
├── dsh-plugin/                   # 原生 DSH 插件包(设置 → 插件)
│   ├── client.js                 # build:plugin 生成
│   ├── cordis.patch.yml
│   └── src/client.template.js
├── web/
│   ├── public/                   # favicon、生成的 icons/ 与 index.json
│   └── src/
│       ├── pages/                # Astro 首页、详情页、sitemap、robots
│       ├── layouts/              # BaseLayout:head、主题、SEO、搜索弹窗
│       ├── components/           # Header、卡片、安装卡、搜索弹窗
│       ├── scripts/              # 原生 TS 交互
│       ├── lib/                  # 类型与格式化
│       ├── styles/global.css     # 手写设计 token 与响应式
│       └── data/index.json       # build-web 生成(gitignored)
├── docs/
│   └── BRANCH_PROTECTION.md      # 标签、Secrets、分支保护配置
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   └── submit-server.yml
│   └── workflows/
│       ├── validate.yml
│       ├── on-issue.yml
│       ├── ci.yml
│       ├── sync.yml
│       └── pages.yml
├── astro.config.mjs
├── tsconfig.json
├── package.json
└── README.md

快速开始

要求 Node.js >=22.12.0。

npm install
npm run check

npm run check 执行:

validate.mjs -> build-index.mjs -> convert-to-official.mjs

本地开发市场:

npm run dev

dev 会先抓取图标、生成 index,再启动 Astro 开发服务器。本地若要启用真实 GitHub / 投稿链接:

$env:SITE_REPO_URL="https://github.com/<owner>/dsh-mcp-center"
npm run dev

macOS / Linux:

SITE_REPO_URL=https://github.com/<owner>/dsh-mcp-center npm run dev

生产构建:

npm run build:site
npm run preview

build:site 生成 index.json、图标、静态详情页和 dist-site/,最后把 HTML 中的根路径资源链接改写为相对路径。GitHub Pages 路径由环境变量注入:

SITE_BASE=/<repo-name>/
SITE_ORIGIN=https://<owner>.github.io
SITE_REPO_URL=https://github.com/<owner>/<repo>

本地预览默认 SITE_BASE=/。页面导航、卡片、图标、搜索索引以及 _astro 资源在构建后都会改写为相对路径;canonical、JSON-LD 和 sitemap 使用绝对 URL。GitHub / 投稿按钮在未设置 SITE_REPO_URL 时回退到 GitHub 首页,部署 workflow 会自动设置。

需要网络的上游检查单独运行:

GITHUB_TOKEN=... npm run check:upstream

构建结果:

| 路径 | 内容 | | --- | --- | | dist/registry.json | 供客户端消费的完整索引,条目 verified: true | | dist/index.json | 市场数据,含安装配置与凭据说明 | | dist/official/*.json | 每个条目对应的官方 server.json | | web/public/icons/ | 构建时抓取的本地图标与回退 SVG | | web/src/data/index.json | Astro 构建时读取的页面数据 | | dist-site/ | 可部署的静态站点 | | dist/sync-summary.json | 最近一次 tools 同步摘要(不提交) |

前端市场

技术栈:Astro 纯静态输出 + 手写 CSS + 原生 TypeScript 交互,无 UI 框架、无运行时后端。

视觉与交互:

  • 深色默认,首次访问跟随 prefers-color-scheme,切换结果写入 localStorage;
  • 主题脚本内联在 <head> 最前,并在 CSS 加载前设置背景色,避免闪白;
  • 强调色仅蓝色 #3b82f6;官方徽章金色、已验证徽章蓝色;
  • 首页:Hero、大搜索框、分类侧栏(移动端横向 chips)、官方/已验证/传输筛选;
  • 卡片:本地图标、徽章、两行简介、分类、工具数、相对校验时间;
  • 搜索与筛选状态写入 ?q=&cat=&official=&verified=&transport=,支持分享与浏览器前进/后退;
  • ⌘K / Ctrl+K 全屏搜索弹窗:Fuse.js、↑↓ 选择、回车跳转、Esc 关闭、命中词高亮;
  • 详情页:安装 Tab、代码复制、占位符高亮、必填变量黄色 callout、折叠工具列表、副作用 ⚠、红色 broken 警告;
  • 每条目独立静态 HTML,含独立 title、description、canonical、JSON-LD;构建时生成 sitemap.xml 与 robots.txt。

图标:

  • fetch-icons.mjs 在构建时抓取每个 homepage 的 favicon;
  • 成功则保存到 web/public/icons/,失败生成“首字母 + 确定性低饱和底色”SVG;
  • 页面只引用本地图标,不运行时热链外站。

详情页安装卡:

  • 每个条目一个静态 HTML:servers/<slug>/index.html;
  • 安装配置按 DSH / Claude Desktop / Cursor / Cline 分四个 Tab,选择记忆到 localStorage;
  • 每个配置块可一键复制,1.5 秒后恢复;
  • env、Header 和 URL 参数全部使用 <YOUR_...> 占位,不包含真实凭据;
  • 凭据表展示申请地址,由 registry 中的 obtain_at 提供;
  • 展示工具清单、仓库、主页、版本、许可证和最近校验时间。

客户端格式:

| 客户端 | stdio | remote | | --- | --- | --- | | DSH | mcpServers + type: stdio | type: streamable-http + url / headers | | Claude Desktop | claude_desktop_config.json 直连 | JSON 配置只支持 stdio,因此用 mcp-remote 桥接;也可用 Settings → Connectors | | Cursor | command / args / env | url / headers | | Cline | type: stdio + disabled / autoApprove | type: streamableHttp 或 sse + url / headers |

Claude Desktop 的远程配置会标注为桥接方案;如果客户端版本已支持直接 URL Connectors,优先使用官方 Connectors UI。

DSH 原生插件

dsh-plugin/ 是一个不嵌入网页、不使用 iframe 的 DSH 插件:

  • 在 设置 → 插件 增加「MCP 市场」Tab
  • React 原生渲染,复用宿主主题 token 和 locale
  • 搜索、分类、详情、四客户端安装 Tab、复制、必填变量、工具副作用
  • 在线目录:插件通过 Host 代理拉取线上 index.json,5 分钟缓存,新增 MCP 无需重新发布插件;无内置目录快照,离线时使用本机缓存或提示目录不可用
  • 原生 MCP 生命周期:插件自己管理连接记录,直接创建 DSH 内置 @deepseek-ai/dsh-mcp-client 条目;不再依赖 dsh-mcp-connector,并会迁移旧连接记录
  • 安装表单直接创建原生 MCP loader 条目;当前支持 Streamable HTTP + Headers 和 stdio
  • 安装时输入凭据会保存插件自己的本机副本:$DSH_PROFILE_DIR/dsh-mcp-center/credentials.json
  • 插件本身不执行 MCP 工具;连接操作走连接器的同源 HTTP API
  • 60 秒 HTML 宣传片:web/public/promo.html,线上地址 /promo.html
npm run build:web
npm run build:plugin

build:plugin 会把 web/src/data/index.json 和本地图标合并进 dsh-plugin/client.js。然后用 plugin_manager 安装:

dsh-plugin/

安装后需要重启一次 DSH(或使用重启按钮/重新打开应用),Client 模块才会加载并显示新的「MCP 市场」Tab。

自动投稿

投稿入口:.github/ISSUE_TEMPLATE/submit-server.yml。

表单字段覆盖 Schema 中的人工可填字段:

  • 名称、展示名、中文简介、英文简介、版本
  • 主页、源码仓库、仓库子目录、厂商
  • 传输类型与 stdio/remote 各自的字段
  • 分类、标签、是否官方、可用客户端、许可证
  • 环境变量、Header、URL 参数的说明、必填/敏感标记与申请地址

凭据行格式:

NAME | 说明 | 是否必填 | 是否敏感 | 申请地址

tools、verified、last_checked 由机器人生成,不需要填写。

流程:

  1. Issue 带 submit 标签时触发 on-issue.yml
  2. scripts/issue-form-to-registry.mjs 解析表单,生成 registry/<首字母>/<namespace>__<server>.yaml
  3. 运行 validate.mjs
  4. 通过则用 AUTOMATION_TOKEN 推送 submit/issue-<number> 分支并创建 PR,正文包含 Closes #<number>
  5. 失败则在 Issue 中更新一条带标记的状态评论,说明具体原因
  6. 同一 Issue 被编辑后会重新解析,并更新原 PR

为什么需要 AUTOMATION_TOKEN

GitHub 会抑制由 GITHUB_TOKEN 创建的 PR 所触发的 pull_request workflow。如果只用 GITHUB_TOKEN,PR 会创建成功,但 ci.yml 永远不会运行。

因此必须配置一个有 Contents / Pull requests 写权限的 PAT 或 GitHub App token,保存为仓库 Secret:AUTOMATION_TOKEN。建议使用专用机器账号或 GitHub App,避免 PR 作者就是唯一维护者而导致无法自我 approve。没有配置时,workflow 会在 Issue 中直接评论缺少配置,而不是创建一个不会跑 CI 的 PR。

完整配置步骤见 docs/BRANCH_PROTECTION.md。

PR CI

.github/workflows/ci.yml 在 PR 打开、更新、重新打开和 review 时运行。

validate job:

  1. npm run validate:Schema、name 查重、文件路径、repository 格式、transport 组合
  2. npm run build && npm run convert:official && npm run build:site:构建索引、官方格式与静态站点
  3. npx astro check:检查 Astro 组件和原生 TS
  4. node scripts/check-upstream.mjs:
    • repository 是否 404(GitHub API,失败时回退 git ls-remote)
    • stdio 条目对应的 npm / PyPI 包和版本是否存在
  5. 全部通过后添加 verified 标签
  6. 失败则移除 verified 标签

approval-gate job:

  • 读取 PR 的 reviewDecision
  • 只有 APPROVED 才通过
  • 必须把 validate 和 approval-gate 配置为分支保护的必需检查,才能真正阻止未 approve 的合并

来自 fork 的 PR 使用只读 GITHUB_TOKEN,verified 标签可能无法自动添加;校验仍会执行。自动投稿 PR 由本仓库创建,不受影响。

Remote tools 同步

.github/workflows/sync.yml 每天 02:17 UTC(10:17 Asia/Shanghai)运行,也支持手动触发。

只处理 streamable_http 和 sse:

  1. 读取 sync/state.json
  2. 对 remote 型执行 MCP initialize,再分页调用 tools/list
  3. 工具清单变化时更新 YAML 的 tools 和 last_checked
  4. 有变化则创建/更新 chore/sync-tools PR;差异消失时关闭过期 PR
  5. 每次运行更新 sync/state.json
  6. 连续失败达到 7 天,创建/更新带 possibly-broken 标签的追踪 Issue
  7. 恢复成功后自动关闭追踪 Issue

stdio 不执行:stdio 同步需要执行第三方代码,存在供应链与沙箱逃逸风险。第一版明确跳过,后续放到隔离沙箱中运行。这是有意留下的 TODO,不是遗漏。

同步凭据

需要认证的条目通过仓库 Secret MCP_SYNC_SECRETS 提供值,registry 里仍然只保存变量名和说明。

{
  "com.lkcoffee/order-mcp": {
    "headers": { "Authorization": "Bearer ..." }
  },
  "com.amap/mcp": {
    "variables": { "key": "..." }
  }
}
  • 缺少必需凭据:状态记为 skipped,发送请求前直接跳过,不增加失败天数
  • 未配置凭据但服务返回 401/403:同样记为 skipped
  • 已配置凭据但认证失败、超时、404、工具名不合法:记为失败
  • 错误写入 state 前会做脱敏和截断

MCP_SYNC_SECRETS 按条目 name 绑定。如果 PR 修改了同名条目的 remote URL,凭据会被发送到新的地址;Review remote URL 变更时必须核对目标主机。

同步带基础 SSRF 防护:只允许 HTTPS,拒绝 localhost、.local、.internal 和解析到私有地址的主机。

possibly-broken 标签

registry 条目本身不是 GitHub Issue,无法直接给 YAML 文件打标签。因此同步任务会为每个连续失败条目维护一个追踪 Issue:

[possibly-broken] com.example/mcp

Issue 带 possibly-broken 标签,正文包含条目路径、连续失败天数、最近成功时间和脱敏后的错误。条目恢复后 Issue 自动关闭;再次连续失败 7 天会重新打开。

失败计数按上海时区按天累计,同一天手动重跑不会重复加一天。状态持久化在 sync/state.json;sync.yml 会直接把这个文件提交到 main。如果启用了分支保护,需要允许 GitHub Actions bypass,或者自行改成状态 PR。

工具清单变化时,sync.yml 同样需要 AUTOMATION_TOKEN 才能创建可触发 CI 的工具同步 PR。详见配置文档。

Registry 条目

命名与文件

name 必须是全局唯一的反向域名格式:

<namespace>/<server-name>
  • GitHub 项目推荐:io.github.<owner>/<repo>
  • 厂商托管服务可使用真实域名倒序:com.lkcoffee/order-mcp、cn.mcd/mcp

允许字符为小写字母、数字、点、连字符、下划线;禁止大写、空格和多于一个斜杠。

文件按 server name 的首字母分片,文件名为把 / 替换成 __:

com.lkcoffee/order-mcp
-> registry/o/com.lkcoffee__order-mcp.yaml

io.github.upstash/context7
-> registry/c/io.github.upstash__context7.yaml

首字母取 <server-name> 的第一个字符,而不是 namespace 的第一个字符。

字段

| 字段 | 必填 | 说明 | | --- | --- | --- | | name | 是 | 全局唯一名称,反向域名格式 | | display_name | 是 | 展示名,最长 80 字符 | | `de

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars3
CategoryDevelopment
Updated16h ago
Forks0

Languages

JavaScript

Trust signals

87/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

2 low