dsh-mcp-center
中文优先的 MCP Server 市场:Git registry + Astro 静态站 + GitHub Pages
Install / Use
claude mcp add Bai-2008 -- npx -y github:Bai-2008/dsh-mcp-centerIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
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.
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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| dsh-mcp-center (this skill)by Bai-2008 | 68 | 3 | today | MCP Server |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.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.
Skill content
View source on GitHubdsh-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 由机器人生成,不需要填写。
流程:
- Issue 带
submit标签时触发on-issue.yml scripts/issue-form-to-registry.mjs解析表单,生成registry/<首字母>/<namespace>__<server>.yaml- 运行
validate.mjs - 通过则用
AUTOMATION_TOKEN推送submit/issue-<number>分支并创建 PR,正文包含Closes #<number> - 失败则在 Issue 中更新一条带标记的状态评论,说明具体原因
- 同一 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:
npm run validate:Schema、name 查重、文件路径、repository 格式、transport 组合npm run build && npm run convert:official && npm run build:site:构建索引、官方格式与静态站点npx astro check:检查 Astro 组件和原生 TSnode scripts/check-upstream.mjs:repository是否 404(GitHub API,失败时回退git ls-remote)- stdio 条目对应的 npm / PyPI 包和版本是否存在
- 全部通过后添加
verified标签 - 失败则移除
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:
- 读取
sync/state.json - 对 remote 型执行 MCP
initialize,再分页调用tools/list - 工具清单变化时更新 YAML 的
tools和last_checked - 有变化则创建/更新
chore/sync-toolsPR;差异消失时关闭过期 PR - 每次运行更新
sync/state.json - 连续失败达到 7 天,创建/更新带
possibly-broken标签的追踪 Issue - 恢复成功后自动关闭追踪 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
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
