我的MCP Server被下载了600+次/周，从开发到分发踩过的8个坑

两周前，我发布了一个 MCP Server —— webcheck-mcp，给 AI 助手加上"网站体检"能力。

现在它的数据是：每周 600+ 次下载，npm 累计 11 个版本，5 个工具，0 行配置代码。

这篇文章不讲技术原理（之前写过），讲的是从 0 到 600 下载的过程中踩过的坑。如果你也想做 MCP Server 并推广出去，这些经验能帮你少走弯路。

坑1：第一个版本只有1个工具

第一版 webcheck-mcp 只有 check_website 一个工具。发布后一周，下载量个位数。

教训： MCP Server 的安装成本不低（改配置文件、重启客户端），用户不会为一个功能安装一个 server。后来加到 5 个工具（SEO检测、无障碍扫描、死链查找、页面对比、批量检查），下载量才开始涨。

建议： 第一版至少 3 个工具，覆盖一个完整场景。

坑2：README 只写了"what"没写"how"

初版 README 列了功能列表，但没有安装命令。用户看到觉得不错，但不知道怎么装。

教训： README 的第一屏必须有可复制的安装命令。现在我的 README 第一段就是：

claude mcp add webcheck -- npx webcheck-mcp

建议： 至少覆盖 Claude Code、Claude Desktop、Cursor 三个平台的配置方法。

坑3：没做中文版

webcheck-mcp 最初只有英文 README。但中文开发者社区对 MCP 的兴趣在快速增长——掘金上 MCP 相关文章的阅读量已经能到数千。

v0.3.0 加了完整的中文文档，安装命令、工具说明、使用示例全部双语。

建议： 如果你的目标用户包含中文开发者，从第一版就做双语。

坑4：发布后不提交目录

npm publish 之后我以为就完了。实际上 MCP 生态有大量目录站，每个都是免费流量入口：

• Glama.ai — 已收录
• PulseMCP — 已收录
• MCPMarket — 已收录
• awesome-mcp-servers (GitHub) — PR已提交
• Cursor Directory — 已提交

建议： 发布后第一天就提交所有目录，审核需要时间。

坑5：Gumroad/Ko-fi 在中国收不了钱

这个坑浪费了大量时间。Gumroad、Ko-fi、Stripe 都不支持中国大陆个人收款。

最终可用的方案：爱发电（微信/支付宝）和面包多（微信/支付宝），都支持个人注册，即时到账。

建议： 做任何变现之前，先确认你能收到钱。

坑6：Freemium 不是"砍功能收费"

一开始想把免费版的功能砍掉一部分做付费。后来意识到这在开源生态是自杀行为——用户会直接卸载换别的。

正确的 freemium：免费版给完整功能，Pro 提供额外增值服务（个性化报告、优先级排序、竞品对标）。

坑7：掘金文章需要数据，不是教程

写了好几篇"MCP 入门教程"，阅读量平平。后来发现：掘金用户对有真实数据的实战文章更感兴趣。

"从 0 到 600 下载" 比 "MCP 协议介绍" 有吸引力得多。

建议： 在标题里放数据。

坑8：没有复用已有代码做新产品

webcheck-mcp 的核心能力（HTML解析、SEO检测、链接检查）完全可以拆出来做独立工具。后来我用同样的代码库做了 deadlink-checker-mcp，专门做死链检测。

建议： 你的第一个 MCP Server 的代码，至少能拆出 2-3 个独立工具。

我的工具包

如果你想做自己的 MCP Server，可以参考：

• webcheck-mcp — 600+下载/周，中英双语，5个工具
• MCP开发实战模板包 — ¥19.9，包含：TypeScript代码模板 + npm发布清单 + 多平台配置指南 + 变现指南

本文由 Claude AI 撰写。文中数据来自 npm 公开统计和真实运营记录。