dsh-armory 2.2.1 → 2.3.1

package/lib/mcp-catalog.js

@@ -1,806 +0,0 @@
-// MCP 服务目录 —— 「MCP 市场」的数据源。
-//
-// ⚠️ 本文件由 `scripts/build-catalog.mjs` 从 `.tasks/mcp-servers-verified.yaml` 生成。
-//    要增删条目请改那份 YAML（它逐条带来源），然后重跑：
-//
-//      node scripts/build-catalog.mjs
-//
-// 为什么目录单独成文件，不留在 `mcp-config.js`：那个文件管**配置读写**（解析 patch、校验
-// serverName、归一化表达式），目录是**数据**。两者变更频率差一个数量级——上游改配置格式可能
-// 几个月一次，收录一个 MCP 是每天都能发生的事。混在一起会让「加一条收录」这种低风险改动
-// 去动一个高风险文件。
-//
-// 字段约定（`test/mcp-catalog.test.mjs` 逐条校验）：
-//
-//   id          短标识，小写连字符。写进配置的 serverName 就是它，所以**一旦发布不能改**。
-//   label       显示名。
-//   summary     一句话说明。
-//   category    见 mcp-config.js 的 MCP_CATEGORIES，市场按它分组。
-//   vendor      提供方。详情页显示，也用来区分官方与第三方。
-//   access      中文，如实说清免费额度与是否需要 Key。**不要美化**。
-//   auth        结构化鉴权标记，取值域见 `AUTH_KINDS`（'none' | 'apiKey' | 'oauth' |
-//               'oauth-or-pat'）。与 `access` 的分工：`access` 给人读，`auth` 给程序判——
-//               面板据此提前告诉用户「这条装不了」，而不是等连接失败了再猜。
-//   authNote    一句话说明「该怎么配」或「为什么装不了」。只在 auth !== 'none' 时写。
-//               可选：省略时面板只显示 auth 的通用文案。
-//   transport   'streamable-http' | 'stdio'。
-//   url/headers 仅 HTTP 型。
-//   command/args 仅 stdio 型。
-//   packages    该服务的包名，用于识别「用户已经装过这一条」。HTTP 型也要写——同一服务常常
-//               既有远端 endpoint 又有本地 npx 包，装了哪种都算装过。这层知识推不出来。
-//   envKeys     用户需要提供哪些环境变量。省略/空 = 不需要凭据。
-//   placeholders args/command 里含 `<占位符>` 的片段。这类条目**装完还不能直接用**，市场会
-//               提示先改；不标出来就会拿 `<仓库路径>` 当真实路径去启动。
-//   homepage    官方文档或仓库。详情页的「文档」入口。
-//
-// 收录纪律：**宁可少，不可错**。一条装不上的配置比没有这条更糟——用户会以为是插件的锅。
-// 所以只收能追到官方文档/官方仓库的条目；拿不到一手来源的宁可不收（哪些被排除、为什么，
-// 见 `.tasks/mcp-servers-report.md`）。
-//
-// ⚠️ 已知边界：DSH 的 mcp-client **不支持 OAuth 交互授权**（transport.ts 只传
-//    `requestInit.headers`，没有 authProvider）。所以只支持 OAuth、拿不到静态 Token 的
-//    远端服务在这个宿主里**用不了**，本目录不收录。`access` 字段如实标注每条要什么凭据。
-//
-// OPT-24：加结构化 `auth` 标记（枚举 AUTH_KINDS），补「access 只有自由文本」的缺口。
-//    为什么：`access` 写得再细也只有人读得到，面板没法据此判断「这条在当前宿主装不上」。
-//    OAuth-only 的条目装完只会得到一个连不上的连接，用户以为是插件的锅。有了这枚枚举，
-//    市场能在点击安装**之前**就把「需 OAuth、本宿主不支持」摊开说。
-//    判定依据仍是 `access` 原文（不凭服务名猜）；拿不准时选 'oauth-or-pat' 而非 'oauth'
-//    —— 误判成 oauth 会让用户以为装不了，代价比反过来大得多。
-
-/**
- * 分类的展示顺序（唯一真相源）。
- *
- * 它靠重排下面的 `MCP_CATALOG` 生效：面板的 chips 取自目录里的**首次出现序**，
- * 所以这个数组的顺序就是用户看到的顺序。改顺序 = 改这里，不要手工重排 MCP_CATALOG。
- * 中文标签见 CATEGORY_LABELS，两者由生成器校验为同一集合。
- * @type {ReadonlyArray<string>}
- */
-export const CATEGORY_ORDER = [
-  'search',
-  'dev',
-  'security',
-  'data',
-  'ai',
-  'browser',
-  'cloud',
-  'productivity',
-  'files',
-  'comms',
-]
-
-/** 分类中文标签。与 CATEGORY_ORDER 同集合（生成时校验）。 */
-export const CATEGORY_LABELS = {
-  'search': '搜索',
-  'dev': '开发工具',
-  'security': '安全与逆向',
-  'data': '数据库与数据',
-  'ai': 'AI 与知识',
-  'browser': '浏览器自动化',
-  'cloud': '云与基础设施',
-  'productivity': '效率协作',
-  'files': '文件与本地',
-  'comms': '通讯',
-}
-
-/**
- * `auth` 字段的取值域（唯一真相源）。
- *
- * - `'none'`         无需任何凭据：本地 stdio、开源本地服务、免密公开 API。
- * - `'apiKey'`       靠 API Key / Token / PAT / headers 注入即可用，`envKeys` 能承载。
- * - `'oauth'`        **只能**走 OAuth 授权流程。本宿主（mcp-client 不支持 OAuth）完成不了，
- *                    面板必须降级提示，不要给用户「点了安装就能用」的错觉。
- * - `'oauth-or-pat'` 官方主推 OAuth，但存在可用的 PAT / 静态令牌替代路径。能装，但需引导
- *                    用户走替代路径，别让他照着官方文档去点 OAuth 按钮。
- *
- * 为什么是这四个而不是布尔：`oauth` 与 `oauth-or-pat` 的处置**相反**（前者劝退、后者引导），
- * 合成就没法表达。测试逐条断言 `MCP_CATALOG` 的 auth 属于这个集合。
- * @type {ReadonlyArray<string>}
- */
-export const AUTH_KINDS = ['none', 'apiKey', 'oauth', 'oauth-or-pat']
-
-/**
- * 目录条目。字段含义见文件头。
- *
- * **数组顺序 = 市场的分类展示顺序**（按 CATEGORY_ORDER 分段排布）。面板的 chips
- * 靠这个顺序渲染，所以不要为了顺手而手工重排——要改顺序请改生成器的 CATEGORY_ORDER。
- * @type {ReadonlyArray<object>}
- */
-export const MCP_CATALOG = [
-  {
-    id: 'exa',
-    label: 'Exa',
-    summary: '网页搜索与内容读取',
-    category: 'search',
-    vendor: 'Exa',
-    access: '免密可用（有限额）；可在 headers 加 x-api-key 提升额度',
-    auth: 'apiKey',
-    authNote: '免密信号是 headers 里的空 x-api-key（实测有限额）；填 EXA_API_KEY 换额度上限',
-    transport: 'streamable-http',
-    url: 'https://mcp.exa.ai/mcp',
-    headers: { 'x-api-key': '!!js (process.env.EXA_API_KEY ?? "")' },
-    packages: ['exa-mcp-server'],
-    envKeys: ['EXA_API_KEY'],
-    homepage: 'https://docs.exa.ai/reference/exa-mcp',
-  },
-  {
-    id: 'tavily',
-    label: 'Tavily',
-    summary: 'AI 优化的搜索与网页提取',
-    category: 'search',
-    vendor: 'Tavily',
-    access: '免密模式免费有速率限制（响应与带 Key 完全一致）；官方免费 Key 为 1000 credits/月，无需信用卡',
-    auth: 'none',
-    transport: 'streamable-http',
-    url: 'https://mcp.tavily.com/mcp/',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.TAVILY_API_KEY ?? "")', 'X-Tavily-Access-Mode': 'keyless' },
-    packages: ['tavily-mcp'],
-    envKeys: ['TAVILY_API_KEY'],
-    homepage: 'https://docs.tavily.com/documentation/mcp',
-  },
-  {
-    id: 'firecrawl',
-    label: 'Firecrawl',
-    summary: '网页抓取、搜索与文档解析',
-    category: 'search',
-    vendor: 'Firecrawl',
-    access: '免密可用（每日限额）；填 API Key 提升额度。需浏览器登录时改用 /v2/mcp-oauth',
-    // 判 apiKey 而非 none：headers 里装配的就是 `Bearer ${FIRECRAWL_API_KEY}`（空串），免密那条路
-    auth: 'apiKey',
-    authNote: '默认按免密模式发空 Bearer；填 FIRECRAWL_API_KEY 才走带 Key 模式',
-    transport: 'streamable-http',
-    url: 'https://mcp.firecrawl.dev/v2/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.FIRECRAWL_API_KEY ?? "")' },
-    packages: ['firecrawl-mcp'],
-    envKeys: ['FIRECRAWL_API_KEY'],
-    homepage: 'https://docs.firecrawl.dev/mcp-server',
-  },
-  {
-    id: 'brave-search',
-    label: 'Brave Search',
-    summary: '独立索引的网页与本地搜索',
-    category: 'search',
-    vendor: 'Brave',
-    access: '必须自备 Brave Search API Key（有免费档，超出需付费）',
-    auth: 'apiKey',
-    authNote: '必填 BRAVE_API_KEY，没有免密路径',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', '@brave/brave-search-mcp-server', '--transport', 'stdio'],
-    packages: ['@brave/brave-search-mcp-server'],
-    envKeys: ['BRAVE_API_KEY'],
-    homepage: 'https://github.com/brave/brave-search-mcp-server',
-  },
-  {
-    id: 'perplexity',
-    label: 'Perplexity',
-    summary: '实时联网搜索与深度研究',
-    category: 'search',
-    vendor: 'Perplexity',
-    access: '需付费 Perplexity API Key（Bearer），无免密额度',
-    auth: 'apiKey',
-    authNote: '必填 PERPLEXITY_API_KEY（Bearer），无免密额度',
-    transport: 'streamable-http',
-    url: 'https://api.perplexity.ai/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.PERPLEXITY_API_KEY ?? "")' },
-    envKeys: ['PERPLEXITY_API_KEY'],
-    homepage: 'https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server',
-  },
-  {
-    id: 'google-maps',
-    label: 'Google Maps',
-    summary: 'Google Maps 平台开发文档检索',
-    category: 'search',
-    vendor: 'Google',
-    access: '实验阶段免费、无需认证（实测 tools/list 返回 2 个文档检索工具）',
-    auth: 'none',
-    transport: 'streamable-http',
-    url: 'https://mapscodeassist.googleapis.com/mcp',
-    homepage: 'https://developers.google.com/maps/ai/code-assist',
-  },
-  {
-    id: 'fetch',
-    label: 'Fetch',
-    summary: '抓取网页并转为适合 LLM 的文本',
-    category: 'search',
-    vendor: 'Anthropic',
-    access: '开源免费，无需任何 Key',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'uvx',
-    args: ['mcp-server-fetch'],
-    packages: ['mcp-server-fetch'],
-    homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/fetch',
-  },
-  {
-    id: 'github',
-    label: 'GitHub',
-    summary: '仓库、Issue、PR 与代码检索',
-    category: 'dev',
-    vendor: 'GitHub',
-    access: '需 GitHub 账号并 OAuth 授权；也可用 PAT。功能权限随账号套餐',
-    // 置 oauth-or-pat 而非 oauth：PAT 是本宿主唯一走得通的路径，标成 oauth 会误导用户放弃安装
-    auth: 'oauth-or-pat',
-    authNote: '别走 OAuth：把 GITHUB_PERSONAL_ACCESS_TOKEN（PAT）配进来，Bearer 直连即可',
-    transport: 'streamable-http',
-    url: 'https://api.githubcopilot.com/mcp/',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.GITHUB_PERSONAL_ACCESS_TOKEN ?? "")' },
-    envKeys: ['GITHUB_PERSONAL_ACCESS_TOKEN'],
-    homepage: 'https://docs.github.com/en/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/use-the-github-mcp-server',
-  },
-  {
-    id: 'gitlab',
-    label: 'GitLab',
-    summary: '项目、Issue 与合并请求访问',
-    category: 'dev',
-    vendor: 'GitLab',
-    access: 'Free 及以上套餐可用；OAuth 动态注册授权，自建实例亦可｜⚠️ 静态 Token 方式未获官方确认（官方 MCP 文档只描述 OAuth/DCR；issue 586184 请求支持 PAT，官方回复不在近期路线图上），在 DSH 中可能无法授权',
-    // 判 oauth：官方明确 PAT 不在近期路线图（issue 586184），没有替代路径可引导
-    auth: 'oauth',
-    authNote: '只支持 OAuth 动态注册，静态 Token 未获官方支持，本宿主会卡在授权；装了也连不上',
-    transport: 'streamable-http',
-    url: 'https://gitlab.com/api/v4/mcp',
-    homepage: 'https://docs.gitlab.com/user/model_context_protocol/mcp_server/',
-  },
-  {
-    id: 'sentry',
-    label: 'Sentry',
-    summary: '错误检索、性能分析与问题分诊',
-    category: 'dev',
-    vendor: 'Sentry',
-    access: '需 Sentry 账号 OAuth 授权（可用免费档账号）',
-    // 判 oauth：access 只承诺 OAuth，没有像 GitHub 那样把 Token 写成等价路径
-    auth: 'oauth',
-    authNote: '官方只写 OAuth；若在 Sentry 设置里签发 SENTRY_AUTH_TOKEN 可试 Bearer 直连（未获文档保证）',
-    transport: 'streamable-http',
-    url: 'https://mcp.sentry.dev/mcp',
-    headers: { 'Authorization': '!!js "Sentry-Bearer " + (process.env.SENTRY_AUTH_TOKEN ?? "")' },
-    envKeys: ['SENTRY_AUTH_TOKEN'],
-    homepage: 'https://docs.sentry.io/product/sentry-mcp/',
-  },
-  {
-    id: 'git',
-    label: 'Git',
-    summary: '读写本地 Git 仓库',
-    category: 'dev',
-    vendor: 'Anthropic',
-    access: '开源免费，仅操作本地仓库',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'uvx',
-    args: ['mcp-server-git', '--repository', '<仓库路径>'],
-    packages: ['mcp-server-git'],
-    placeholders: ['<仓库路径>'],
-    homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/git',
-  },
-  {
-    id: 'serena',
-    label: 'Serena',
-    summary: '符号级代码检索与重构',
-    category: 'dev',
-    vendor: 'Oraios AI',
-    access: '开源免费（MIT），本地运行；需先 uv tool install -p 3.13 serena-agent',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'serena',
-    args: ['start-mcp-server', '--context', 'ide', '--project-from-cwd'],
-    packages: ['serena'],
-    homepage: 'https://oraios.github.io/serena/02-usage/030_clients.html',
-  },
-  {
-    id: 'everything',
-    label: 'Everything',
-    summary: '官方参考实现，用于连通性自检',
-    category: 'dev',
-    vendor: 'Anthropic',
-    access: '开源免费，演示与测试用途',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', '@modelcontextprotocol/server-everything'],
-    packages: ['@modelcontextprotocol/server-everything'],
-    homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/everything',
-  },
-  {
-    id: 'fast-context',
-    label: 'Fast Context',
-    summary: 'Windsurf 驱动的语义代码检索',
-    category: 'dev',
-    vendor: 'Windsurf',
-    access: '开源免费；装了 Windsurf 会自动读取其 Key，没有才需自备 WINDSURF_API_KEY',
-    auth: 'apiKey',
-    authNote: '装了 Windsurf 会自动取 Key；否则填 WINDSURF_API_KEY',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', 'fast-context-mcp'],
-    packages: ['fast-context-mcp'],
-    envKeys: ['WINDSURF_API_KEY'],
-    homepage: 'https://www.npmjs.com/package/fast-context-mcp',
-  },
-  {
-    id: 'jshook',
-    label: 'JS Hook',
-    summary: 'JS 分析与安全研究：Hook、CDP 调试、反混淆',
-    category: 'security',
-    vendor: 'jshookmcp',
-    access: '开源免费（AGPL-3.0），本地运行；需 Node 22.12+。工具档位由环境变量 MCP_TOOL_PROFILE 控制（search ≈3K tokens / workflow / full ≈40K+），默认档已够用',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', '@jshookmcp/jshook@latest'],
-    packages: ['@jshookmcp/jshook'],
-    homepage: 'https://vmoranv.github.io/jshookmcp/',
-  },
-  {
-    id: 'ida-pro',
-    label: 'IDA Pro',
-    summary: '驱动 IDA Pro 做逆向分析',
-    category: 'security',
-    vendor: 'mrexodia',
-    access: '需本机已装 IDA Pro；服务本身按需拉取，无需预先 pip install',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'uvx',
-    args: ['--with', 'mcp<2', '--with', 'ida-pro-mcp', 'ida-pro-mcp'],
-    packages: ['ida-pro-mcp'],
-    homepage: 'https://github.com/mrexodia/ida-pro-mcp',
-  },
-  {
-    id: 'frida-mcp',
-    label: 'Frida',
-    summary: 'Frida 动态插桩：Hook 函数、跟踪调用',
-    category: 'security',
-    vendor: 'dnakov',
-    access: '开源免费（MIT），本地运行；需本机装 Frida 与被测目标。实测 uvx 启动并完成 initialize/tools/list 握手，enumerate_processes 可正常返回本机进程',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'uvx',
-    args: ['--with', 'mcp<2', '--with', 'frida-mcp', 'frida-mcp'],
-    packages: ['frida-mcp'],
-    homepage: 'https://github.com/dnakov/frida-mcp',
-  },
-  {
-    id: 'dbx',
-    label: 'DBX',
-    summary: '多数据库查询（Postgres / MySQL / SQLite 等）',
-    category: 'data',
-    vendor: 't8y2',
-    access: '开源免费，本地原生二进制；数据源在 DBX 应用里配置',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', '@dbx-app/mcp-server'],
-    packages: ['@dbx-app/mcp-server'],
-    homepage: 'https://github.com/t8y2/dbx',
-  },
-  {
-    id: 'postgres',
-    label: 'PostgreSQL',
-    summary: 'Postgres 查询、索引与健康分析',
-    category: 'data',
-    vendor: 'Crystal DBA',
-    access: '开源免费，需自备数据库连接串（DATABASE_URI）',
-    auth: 'apiKey',
-    authNote: '填 DATABASE_URI（数据库连接串，含口令）',
-    transport: 'stdio',
-    command: 'uvx',
-    args: ['--with', 'mcp<2', 'postgres-mcp', '--access-mode=unrestricted'],
-    packages: ['postgres-mcp'],
-    envKeys: ['DATABASE_URI'],
-    homepage: 'https://github.com/crystaldba/postgres-mcp',
-  },
-  {
-    id: 'sqlite',
-    label: 'SQLite',
-    summary: '本地 SQLite 查询与数据分析',
-    category: 'data',
-    vendor: 'Anthropic',
-    access: '开源免费，只操作本地 .db 文件。注意：官方已归档，仅有维护性修复',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'uvx',
-    args: ['mcp-server-sqlite', '--db-path', '<数据库路径>'],
-    packages: ['mcp-server-sqlite'],
-    placeholders: ['<数据库路径>'],
-    homepage: 'https://github.com/modelcontextprotocol/servers-archived/tree/main/src/sqlite',
-  },
-  {
-    id: 'redis',
-    label: 'Redis',
-    summary: 'Redis 键值、向量与流操作',
-    category: 'data',
-    vendor: 'Redis',
-    access: '开源免费（MIT），需自备 Redis 实例',
-    auth: 'apiKey',
-    authNote: '填 REDIS_HOST / REDIS_PORT；实例要口令时一并给',
-    transport: 'stdio',
-    command: 'uvx',
-    args: ['--from', 'redis-mcp-server@latest', 'redis-mcp-server', '--url', 'redis://localhost:6379/0'],
-    packages: ['redis-mcp-server'],
-    configKeys: ['REDIS_HOST', 'REDIS_PORT'],
-    homepage: 'https://redis.io/docs/latest/integrate/redis-mcp/',
-  },
-  {
-    id: 'clickhouse',
-    label: 'ClickHouse',
-    summary: 'ClickHouse 查询与库表探查',
-    category: 'data',
-    vendor: 'ClickHouse',
-    access: '开源免费，默认只读；需自备 ClickHouse 连接信息',
-    auth: 'apiKey',
-    authNote: '填 CLICKHOUSE_HOST / PORT / USER 与 CLICKHOUSE_PASSWORD',
-    transport: 'stdio',
-    command: 'uv',
-    args: ['run', '--with', 'mcp-clickhouse', '--python', '3.12', 'mcp-clickhouse'],
-    packages: ['mcp-clickhouse'],
-    envKeys: ['CLICKHOUSE_PASSWORD'],
-    configKeys: ['CLICKHOUSE_HOST', 'CLICKHOUSE_PORT', 'CLICKHOUSE_USER'],
-    homepage: 'https://github.com/ClickHouse/mcp-clickhouse',
-  },
-  {
-    id: 'mongodb',
-    label: 'MongoDB',
-    summary: 'MongoDB 与 Atlas 数据访问',
-    category: 'data',
-    vendor: 'MongoDB',
-    access: '开源免费（Apache-2.0），需自备连接串',
-    auth: 'apiKey',
-    authNote: '填 MDB_MCP_CONNECTION_STRING（含口令的连接串）',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', 'mongodb-mcp-server@latest', '--readOnly'],
-    packages: ['mongodb-mcp-server'],
-    envKeys: ['MDB_MCP_CONNECTION_STRING'],
-    homepage: 'https://www.mongodb.com/docs/mcp-server/get-started/',
-  },
-  {
-    id: 'supabase',
-    label: 'Supabase',
-    summary: 'Supabase 项目与数据库管理',
-    category: 'data',
-    vendor: 'Supabase',
-    access: '需 Supabase 账号 OAuth 授权；支持 ?read_only=true 等参数收敛权限',
-    // 判 oauth：access 只承诺 OAuth，Token 那条路属于未文档化能力
-    auth: 'oauth',
-    authNote: '官方写的是 OAuth；有 SUPABASE_ACCESS_TOKEN 的话可试 Bearer 直连（未获文档保证）',
-    transport: 'streamable-http',
-    url: 'https://mcp.supabase.com/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.SUPABASE_ACCESS_TOKEN ?? "")' },
-    envKeys: ['SUPABASE_ACCESS_TOKEN'],
-    homepage: 'https://supabase.com/docs/guides/getting-started/mcp',
-  },
-  {
-    id: 'neon',
-    label: 'Neon',
-    summary: 'Neon 项目管理与查询',
-    category: 'data',
-    vendor: 'Neon',
-    access: '需 Neon 账号 OAuth 或 API Key；可选只读模式与单项目限定',
-    auth: 'oauth-or-pat',
-    authNote: '官方主推 OAuth；改用 NEON_API_KEY 作 Bearer 即可直连',
-    transport: 'streamable-http',
-    url: 'https://mcp.neon.tech/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.NEON_API_KEY ?? "")' },
-    envKeys: ['NEON_API_KEY'],
-    homepage: 'https://neon.com/docs/ai/neon-mcp-server',
-  },
-  {
-    id: 'deepwiki-fetch',
-    label: 'DeepWiki（本地抓取）',
-    summary: '抓取 DeepWiki 页面转成 Markdown',
-    category: 'ai',
-    vendor: 'regenrek',
-    access: '完全免费，无需认证；本地进程抓取，与官方远端版功能重叠，按需选一个',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', 'mcp-deepwiki@latest'],
-    packages: ['mcp-deepwiki'],
-    homepage: 'https://github.com/regenrek/deepwiki-mcp',
-  },
-  {
-    id: 'memory',
-    label: 'Memory',
-    summary: '基于知识图谱的持久记忆',
-    category: 'ai',
-    vendor: 'Anthropic',
-    access: '开源免费，数据存于本地文件',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', '@modelcontextprotocol/server-memory'],
-    packages: ['@modelcontextprotocol/server-memory'],
-    homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/memory',
-  },
-  {
-    id: 'sequential-thinking',
-    label: 'Sequential Thinking',
-    summary: '分步推理与动态问题拆解',
-    category: 'ai',
-    vendor: 'Anthropic',
-    access: '开源免费，无需任何 Key',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', '@modelcontextprotocol/server-sequential-thinking'],
-    packages: ['@modelcontextprotocol/server-sequential-thinking'],
-    homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking',
-  },
-  {
-    id: 'context7',
-    label: 'Context7',
-    summary: '实时获取库的最新版本文档',
-    category: 'ai',
-    vendor: 'Upstash',
-    access: '免密可用；官网可领免费 API Key 提升速率上限',
-    auth: 'none',
-    transport: 'streamable-http',
-    url: 'https://mcp.context7.com/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.CONTEXT7_API_KEY ?? "")' },
-    envKeys: ['CONTEXT7_API_KEY'],
-    homepage: 'https://github.com/upstash/context7',
-  },
-  {
-    id: 'deepwiki',
-    label: 'DeepWiki',
-    summary: '代码仓库文档与问答',
-    category: 'ai',
-    vendor: 'Cognition (Devin)',
-    access: '完全免费，无需认证，仅访问公开仓库',
-    auth: 'none',
-    transport: 'streamable-http',
-    url: 'https://mcp.deepwiki.com/mcp',
-    homepage: 'https://docs.devin.ai/work-with-devin/deepwiki-mcp',
-  },
-  {
-    id: 'huggingface',
-    label: 'Hugging Face',
-    summary: '模型、数据集与 Spaces 检索',
-    category: 'ai',
-    vendor: 'Hugging Face',
-    access: '免密可用基础工具；登录后可选用个人已配置的 App 与工具',
-    auth: 'none',
-    transport: 'streamable-http',
-    url: 'https://huggingface.co/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.HF_TOKEN ?? "")' },
-    envKeys: ['HF_TOKEN'],
-    homepage: 'https://huggingface.co/mcp',
-  },
-  {
-    id: 'arxiv',
-    label: 'arXiv',
-    summary: '论文检索与全文获取',
-    category: 'ai',
-    vendor: 'Blazick（社区维护，非 arXiv 官方）',
-    access: '开源免费，无需 Key',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'uvx',
-    args: ['arxiv-mcp-server'],
-    packages: ['arxiv-mcp-server'],
-    homepage: 'https://github.com/blazickjp/arxiv-mcp-server',
-  },
-  {
-    id: 'chrome-devtools',
-    label: 'Chrome DevTools',
-    summary: '驱动真实 Chrome 调试与性能分析',
-    category: 'browser',
-    vendor: 'Google',
-    access: '开源免费，本地运行；需本机安装 Chrome',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', 'chrome-devtools-mcp@latest'],
-    packages: ['chrome-devtools-mcp'],
-    homepage: 'https://github.com/ChromeDevTools/chrome-devtools-mcp',
-  },
-  {
-    id: 'playwright',
-    label: 'Playwright',
-    summary: '基于可访问性快照的浏览器自动化',
-    category: 'browser',
-    vendor: 'Microsoft',
-    access: '开源免费（Apache-2.0），本地运行；需 Node.js 18+',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', '@playwright/mcp@latest'],
-    packages: ['@playwright/mcp'],
-    homepage: 'https://github.com/microsoft/playwright-mcp',
-  },
-  {
-    id: 'cloudflare-api',
-    label: 'Cloudflare API',
-    summary: '调用全部 Cloudflare API',
-    category: 'cloud',
-    vendor: 'Cloudflare',
-    access: '需 Cloudflare 账号 OAuth 授权；也可用 API Token 作 Bearer',
-    auth: 'oauth-or-pat',
-    authNote: '官方主推 OAuth；改用 CLOUDFLARE_API_TOKEN 作 Bearer 即可直连',
-    transport: 'streamable-http',
-    url: 'https://mcp.cloudflare.com/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.CLOUDFLARE_API_TOKEN ?? "")' },
-    envKeys: ['CLOUDFLARE_API_TOKEN'],
-    homepage: 'https://developers.cloudflare.com/agents/model-context-protocol/mcp-servers-for-cloudflare/',
-  },
-  {
-    id: 'cloudflare-docs',
-    label: 'Cloudflare Docs',
-    summary: 'Cloudflare 官方文档语义检索',
-    category: 'cloud',
-    vendor: 'Cloudflare',
-    access: '免密可用，无需任何账号',
-    auth: 'none',
-    transport: 'streamable-http',
-    url: 'https://docs.mcp.cloudflare.com/mcp',
-    homepage: 'https://developers.cloudflare.com/agents/model-context-protocol/mcp-servers-for-cloudflare/',
-  },
-  {
-    id: 'aws',
-    label: 'AWS',
-    summary: '通过 mcp-proxy-for-aws 访问 AWS 服务',
-    category: 'cloud',
-    vendor: 'Amazon Web Services',
-    access: '开源免费；凭据取自本机 AWS 配置（~/.aws），需可访问 Bedrock',
-    auth: 'apiKey',
-    authNote: '凭据取自本机 ~/.aws，无需在此填 Key；账号需能访问 Bedrock',
-    transport: 'stdio',
-    command: 'uvx',
-    args: ['mcp-proxy-for-aws@latest', 'https://aws-mcp.us-east-1.api.aws/mcp'],
-    packages: ['mcp-proxy-for-aws'],
-    homepage: 'https://github.com/aws/mcp-proxy-for-aws',
-  },
-  {
-    id: 'kubernetes',
-    label: 'Kubernetes',
-    summary: '集群资源、Pod 与 Helm 管理',
-    category: 'cloud',
-    vendor: 'Red Hat / CNCF',
-    access: '开源免费（Apache-2.0），使用本机 kubeconfig',
-    auth: 'apiKey',
-    authNote: '用本机 kubeconfig 的凭据，无需在此填 Key；集群需可连通',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', 'kubernetes-mcp-server@latest'],
-    packages: ['kubernetes-mcp-server'],
-    homepage: 'https://github.com/containers/kubernetes-mcp-server',
-  },
-  {
-    id: 'docker',
-    label: 'Docker MCP Gateway',
-    summary: '以容器隔离方式统一运行 MCP',
-    category: 'cloud',
-    vendor: 'Docker',
-    access: '开源免费（MIT），需 Docker Desktop 或 docker CLI 插件',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'docker',
-    args: ['mcp', 'gateway', 'run'],
-    homepage: 'https://github.com/docker/mcp-gateway',
-  },
-  {
-    id: 'netlify',
-    label: 'Netlify',
-    summary: '站点构建部署与 Netlify CLI',
-    category: 'cloud',
-    vendor: 'Netlify',
-    access: '需 Netlify 账号 OAuth 授权｜⚠️ 静态 Token 方式未获官方确认（官方文档的 NETLIFY_PERSONAL_ACCESS_TOKEN 是本地 stdio 包的环境变量，远端端点只文档化了 OAuth），在 DSH 中可能无法授权',
-    // 判 oauth：NETLIFY_PERSONAL_ACCESS_TOKEN 只对本地 stdio 包成立，远端端点拿不到替代路径
-    auth: 'oauth',
-    authNote: '远端端点只文档化了 OAuth，静态 Token 未获官方确认，本宿主会卡在授权；装了也连不上',
-    transport: 'streamable-http',
-    url: 'https://netlify-mcp.netlify.app/mcp',
-    homepage: 'https://docs.netlify.com/build/build-with-ai/netlify-mcp-server/',
-  },
-  {
-    id: 'linear',
-    label: 'Linear',
-    summary: 'Issue、项目与评论管理',
-    category: 'productivity',
-    vendor: 'Linear',
-    access: '需 Linear 账号 OAuth；只读可用 https://mcp.linear.app/mcp/readonly',
-    auth: 'oauth',
-    authNote: '官方写的是 OAuth；LINEAR_API_KEY 作 Bearer 未见文档支持，装了大概率连不上',
-    transport: 'streamable-http',
-    url: 'https://mcp.linear.app/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.LINEAR_API_KEY ?? "")' },
-    envKeys: ['LINEAR_API_KEY'],
-    homepage: 'https://linear.app/docs/mcp',
-  },
-  {
-    id: 'atlassian',
-    label: 'Atlassian (Jira/Confluence)',
-    summary: 'Jira 与 Confluence 读写',
-    category: 'productivity',
-    vendor: 'Atlassian',
-    access: '有免费档（无需信用卡）；需 Atlassian 账号 OAuth 授权',
-    auth: 'oauth',
-    authNote: '官方写的是 OAuth；ATLASSIAN_API_TOKEN 作 Bearer 未见文档支持，装了大概率连不上',
-    transport: 'streamable-http',
-    url: 'https://mcp.atlassian.com/v2/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.ATLASSIAN_API_TOKEN ?? "")' },
-    envKeys: ['ATLASSIAN_API_TOKEN'],
-    homepage: 'https://support.atlassian.com/atlassian-ai-gateway/docs/get-started-with-the-atlassian-remote-mcp-server/',
-  },
-  {
-    id: 'airtable',
-    label: 'Airtable',
-    summary: '读写 Airtable 库表与记录',
-    category: 'productivity',
-    vendor: 'Airtable',
-    access: '全部套餐可用（含免费档）；需 Airtable OAuth 授权',
-    auth: 'oauth',
-    authNote: '官方写的是 OAuth；AIRTABLE_TOKEN 作 Bearer 未见文档支持，装了大概率连不上',
-    transport: 'streamable-http',
-    url: 'https://mcp.airtable.com/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.AIRTABLE_TOKEN ?? "")' },
-    envKeys: ['AIRTABLE_TOKEN'],
-    homepage: 'https://support.airtable.com/articles/9897799762-using-the-airtable-mcp-server',
-  },
-  {
-    id: 'microsoft-learn',
-    label: 'Microsoft Learn',
-    summary: '微软官方文档与代码示例检索',
-    category: 'productivity',
-    vendor: 'Microsoft',
-    access: '完全免费，无需认证、无需账号',
-    auth: 'none',
-    transport: 'streamable-http',
-    url: 'https://learn.microsoft.com/api/mcp',
-    homepage: 'https://learn.microsoft.com/en-us/training/support/mcp',
-  },
-  {
-    id: 'time',
-    label: 'Time',
-    summary: '时间查询与时区换算',
-    category: 'productivity',
-    vendor: 'Anthropic',
-    access: '开源免费，纯本地计算',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'uvx',
-    args: ['mcp-server-time'],
-    packages: ['mcp-server-time'],
-    homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/time',
-  },
-  {
-    id: 'filesystem',
-    label: 'Filesystem',
-    summary: '受限目录内的文件读写',
-    category: 'files',
-    vendor: 'Anthropic',
-    access: '开源免费，仅能访问命令行中显式授权的目录',
-    auth: 'none',
-    transport: 'stdio',
-    command: 'npx',
-    args: ['-y', '@modelcontextprotocol/server-filesystem', '<允许访问的目录>'],
-    packages: ['@modelcontextprotocol/server-filesystem'],
-    placeholders: ['<允许访问的目录>'],
-    homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem',
-  },
-  {
-    id: 'slack',
-    label: 'Slack',
-    summary: '搜索消息、发消息与管理画板',
-    category: 'comms',
-    vendor: 'Slack',
-    access: '需先自建 Slack App 并走一次 OAuth 换出 xoxp- 用户令牌，再把该令牌配到这里；令牌本身可长期复用',
-    // 判 oauth-or-pat：OAuth 只发生在建 App 那一次，落到本宿主的是可长期复用的静态令牌
-    auth: 'oauth-or-pat',
-    authNote: '先在 Slack 建 App 走一次 OAuth 换出 xoxp- 用户令牌，填 SLACK_USER_TOKEN 即可长期复用',
-    transport: 'streamable-http',
-    url: 'https://mcp.slack.com/mcp',
-    headers: { 'Authorization': '!!js "Bearer " + (process.env.SLACK_USER_TOKEN ?? "")' },
-    envKeys: ['SLACK_USER_TOKEN'],
-    homepage: 'https://docs.slack.dev/ai/slack-mcp-server/developing',
-  },
-]
-
-/**
- * 按 id 建索引。多个消费者（市场列表、详情页、安装路径）都用它，避免各自 `find`。
- * @param {ReadonlyArray<object>} [catalog] - 目录，缺省用内置目录。
- * @returns {Map<string, object>} id → 条目。
- */
-export function catalogById(catalog = MCP_CATALOG) {
-  return new Map(catalog.map((entry) => [entry.id, entry]))
-}