allmcps-server

allmcps-server

AllMCPs.com 的官方本地 MCP 服务和命令行工具：AllMCPs.com — 可直接通过 Claude、Cursor、任何兼容 MCP 的 Agent 或普通 shell 脚本搜索、浏览、获取安装配置并提交 Model Context Protocol（MCP）服务。

此软件包是连接到 AllMCPs 远程 MCP 端点的轻量级 stdio 桥接。工具行为由服务端处理，因此此软件包始终提供当前实时工具集；添加或更改工具时，无需升级软件包。

v2.0.0 将单一的 submit_mcp 工具替换为以下完整工具集，其中包括更名后的 submit_mcp_server（原名为 submit_mcp）。如果你依赖旧工具名称，请固定使用 allmcps-server@1。

安装

需要 Node.js 18+。将以下内容添加到 MCP 客户端配置（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "allmcps": {
      "command": "npx",
      "args": ["-y", "allmcps-server"]
    }
  }
}

命令行模式

使用子命令运行，而非直接运行 npx allmcps-server，即可将其作为基于 公共 REST API 的普通脚本化命令行工具，无需 MCP 客户端：

npx allmcps-server search postgres      # search the directory
npx allmcps-server categories           # list every category
npx allmcps-server server <id>          # full detail for one listing
npx allmcps-server help                 # usage

每条命令都会将 JSON 输出到 stdout，因此可以与 jq 和其他 Unix 工具组合使用。不带子命令时，它会作为下文所述的 MCP stdio 服务运行（这是默认的 npx allmcps-server 行为）。

工具

工具	必需参数	描述
search_mcp_servers	—	按关键词和／或类别搜索；可选的 transport（remote/stdio）和 verified_only 筛选条件。
get_mcp_install_config	id	获取 13 种客户端的服务设置（Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Cline、Zed、Codex、Gemini CLI、JetBrains、Roo Code、Continue、LM Studio）；可选 client，用于指定单个客户端。
get_mcp_alternatives	id	获取同一类别中某个服务的替代方案。
compare_mcp_servers	ids（2 到 4 个）	并排比较：安装、有效性证据、工具、健康状况、星标数、最近提交时间和质量评分。
recommend_mcp_stack	role	为某个角色或工作流推荐一组精简且互补的服务。
list_mcp_categories	—	列出所有类别及其服务数量。
get_boost_pricing	—	获取推广／推荐展示的价格和功能。
boost_mcp_server	id	开始赞助／推广订单——返回 Stripe 结账 URL 和 x402 发票。
get_boost_status	id	查看某个条目的推广状态和已验证徽章状态。
submit_mcp_server	name、url、email	向目录提交新的 MCP 服务。
verify_mcp_claim	id	通过 GitHub README、网站徽章或 DNS 验证所有权并认领条目。
register_mcp_agent	email	开始无人值守 Agent 注册——通过邮件发送确认码。
confirm_mcp_agent	email、code	将邮件中的确认码兑换为 bearer 令牌（见下文）。

submit_mcp_server 提交的内容会进入 allmcps.com 的 pending 审核队列。 响应中包含 claim_url 和可直接粘贴的 badge_markdown 片段——将该徽章添加到 仓库的 README 中，即可立即验证该条目，无需等待人工审核。

verify_mcp_claim 通常需要登录 AllMCPs，而无人值守 Agent 无法登录。 如需在没有浏览器会话的情况下认领：调用 register_mcp_agent，从其发送的邮件中获取确认码， 调用 confirm_mcp_agent 生成 bearer 令牌，然后在调用 verify_mcp_claim 时将该令牌作为 agentToken 传入。 完整规范：https://allmcps.com/auth.md

每个工具的完整输入架构（包括 category、description、sku 和 method 等可选参数）可在运行时通过标准 MCP tools/list 调用获取，也可以直接查看 /api/mcp。

配置

环境变量	默认值	用途
ALLMCPS_MCP_URL	https://allmcps.com/api/mcp	覆盖此软件包桥接到的远程端点。

相关链接

• 目录 API 文档：https://allmcps.com/docs/api
• 远程 MCP 服务（相同工具，可直接通过 HTTP 调用）：https://allmcps.com/api/mcp
• 也已列入 官方 MCP Registry，名称为 io.github.Jackalope-Dev/allmcps-server；也可在 Glama 和 LobeHub Marketplace 上找到

许可证

MIT © Jackalope Digital — 详见 LICENSE。