LeonxLJX/dsh-mcp-market

dsh-mcp-market

DeepSeek Harness 通往 MCP 的前门。 搜索经过验证的 MCP 服务器目录，一步获取可将服务器接入官方 @deepseek-ai/dsh-mcp-client 桥接器的精确 cordis.yml 配置行。

npm license node

DeepSeek Harness 是一个全插件化的 Cordis agent harness。插件带来工具。官方 MCP 桥接器已经知道如何与任何 MCP 服务器通信——但仍需要有人告诉你该运行哪个服务器，以及什么确切配置能让它正常工作。

那个“有人”就是 dsh-mcp-market。

- 📦 经过验证的目录——每个条目都由 scripts/build-catalog.mjs 针对实时 npm registry 进行探测；返回 404 的包会被丢弃，版本会固定为实际存在的版本。没有手写猜测。
- 🔌 单工具插件——加载 dsh-mcp-market 后，agent 本身即可搜索目录并读取任何服务器的接线配置（mcp_market_search）。
- 🧩 零配置 CLI——dsh-mcp-market add github 会将精确的配置行追加到你的 overlay mcp-servers.cordis.yml，且具备幂等性。

为什么存在

| 层级 | 由谁提供 | 状态 |
|---|---|---|
| MCP 协议服务器 | @modelcontextprotocol/server- + 社区 | ✅ 已有数千个 |
| MCP → dsh 工具桥接 | @deepseek-ai/dsh-mcp-client | ✅ 官方 |
| 发现 + 验证配置 | dsh-mcp-market | 🟩 本项目 |

桥接器是按服务器配置的：一行 cordis.yml，包含正确的包名、正确的版本、正确的环境变量键。其中任何一项出错，工具就会悄无声息地永远不出现。生态系统有了桥接器，却没有前门*——这个缺口正是本插件要填补的。

安装

作为 harness 插件（在 harness 应用的 package.json 中声明，或通过插件管理器安装）：

npm install dsh-mcp-market

它是一个 Cordis 插件，并且只注册一个工具。将其添加到你的 cordis.yml：

plugins:
mcp-market:
optional: default result limit for the search tool (1-10)
config:
defaultLimit: 5

需要与官方桥接器相同的 peer 依赖集：@deepseek-ai/dsh-tools 和 @deepseek-ai/cordis。仅支持 ESM（"type": "module"），Node ≥ 20。

CLI 也可以在不接触 harness 的情况下独立使用：

npx dsh-mcp-market search github
npx dsh-mcp-market add github --out mcp-servers.cordis.yml

用法

作为 harness 工具

插件加载后，agent 可以运行 mcp_market_search，传入自由文本 query、可选的 category 和可选的 limit。结果是一个按排名排列的匹配服务器列表，每个都包含：

- 包 + 固定版本，
- 服务器期望的环境变量键，
- 可直接复制的精确 cordis.yml 配置行。

示例（当被要求“添加一个搜索工具”时，agent 看到的内容）：

mcp_market_search(query="github")
1. github — GitHub MCP 服务器（@modelcontextprotocol/server-github@2025.4.8）
env: GITHUB_TOKEN（个人访问令牌；repo + read:org 权限范围）
category: dev
接入方式：
yaml
- id: github
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: github
transport: stdio
command: npx
args: ['-y', '@modelcontextprotocol/server-github@2025.4.8']
env:
GITHUB_TOKEN: !!js process.env.GITHUB_TOKEN

通过 CLI

dsh-mcp-market

Commands:
search             Search the catalog
add  [--out file]     Append a server's cordis.yml row to an overlay file
(idempotent — never duplicates). Default out:
mcp-servers.cordis.yml
ls [--category cat]       List all servers (optionally filtered)
categories                List available categories

$ dsh-mcp-market search postgres
postgres — Postgres MCP server (@modelcontextprotocol/server-postgres@0.6.2)

$ dsh-mcp-market add memory
appending managed block to mcp-servers.cordis.yml

$ cat mcp-servers.cordis.yml
- id: memory
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: memory
transport: stdio
command: npx
args: ['-y', '@modelcontextprotocol/server-memory@0.6.2']
env: {}

该 overlay 文件旨在通过 !include 引入或合并到 harness 的 cordis.yml 中，与官方 bridge 自身的行并列。由 CLI 添加的行会被包裹在 # --- dsh-mcp-market managed block --- 标记中；对同一 id 重新运行 add 是无操作。

目录

catalog/catalog.json 目前包含 17 个已验证的服务器（均已针对 npm 进行探测）：

| id | package | tags |
|---|---|---|
| filesystem | @modelcontextprotocol/server-filesystem | official, files |
| memory | @modelcontextprotocol/server-memory | official, memory |
| sequential-thinking | @modelcontextprotocol/server-sequential-thinking | official, thinking |
| everything | @modelcontextprotocol/server-everything | official, demo |
| github | @modelcontextprotocol/server-github | official, dev |
| slack | @modelcontextprotocol/server-slack | official, chat |
| postgres | @modelcontextprotocol/server-postgres | official, db |
| brave-search | @modelcontextprotocol/server-brave-search | official, search |
| google-maps | @modelcontextprotocol/server-google-maps | official, geo |
| pdf | @modelcontextprotocol/server-pdf | official, files |
| gdrive | @modelcontextprotocol/server-gdrive | official, files |
| puppeteer | @modelcontextprotocol/server-puppeteer | official, browser |
| playwright | @playwright/mcp | browser |
| puppeteer-mcp-server | puppeteer-mcp-server | browser |
| figma | figma-developer-mcp | design |
| tavily | tavily-mcp | search |
| firecrawl | firecrawl-mcp | scrape |

重新生成目录

该目录是生成的，而非人工整理的：

npm run catalog        # scripts/build-catalog.mjs → 探测 npm，写入 catalog/catalog.json

要添加候选项，请扩展 scripts/build-catalog.mjs 中的 CANDIDATES 数组并重新运行。该脚本会解析实时的 latest 版本，获取 description/homepage，并丢弃任何在注册表中返回 404 的包——发布的目录中只会包含可安装的服务器。

开发

npm install
npm run typecheck     # tsc --noEmit
npm run test          # build + node --test tests/market.test.mjs（9 个用例）
npm run catalog       # 从实时 npm 数据重新生成 catalog/catalog.json

测试套件锁定了重要的约定：

- 每个目录条目都能解析，并且具有唯一的 id，
- searchCatalog 按 id > package > tags > description 排序（github 查询 → github 服务器排在首位），
- 空查询且无分类时返回 []（浏览功能保留给 ls），
- buildRow 输出的格式与官方 @deepseek-ai/dsh-mcp-client 所消费的格式完全一致，
- parseCatalog 会拒绝结构无效的载荷。

项目结构

dsh-mcp-market/
├── src/
│   ├── index.ts      # Cordis 插件入口：name / inject / apply
│   ├── tool.ts       # mcp_market_search 工具注册（defineTool）
│   ├── catalog.ts    # 目录 URL 解析 + 结构解析
│   ├── search.ts     # 分词器 + 排序搜索 + 分类
│   ├── snippet.ts    # cordis.yml 行 + 安装命令构建器
│   └── types.ts      # 公共类型
├── cli/index.mjs     # search / add / ls / categories
├── scripts/build-catalog.mjs  # 实时 npm 探测 → catalog/catalog.json
├── catalog/catalog.json       # 生成，已提交
└── tests/market.test.mjs      # 9 个约定测试（node:test）

许可证

MIT © 2026 LeonxLJX — 参见 LICENSE。