SaaS Puppy

SaaS Puppy MCP

让你的 AI 助手在 SaaS Puppy 中查找信息。SaaS Puppy 是一个免费层级开发者工具目录。

询问某个工具的信息，也可以让它比较两三个工具。对于每个工具，你都能了解免费方案包含的内容、优缺点以及其中的限制，并获得完整条目的链接。

• 无需注册、无需 API 密钥、完全免费。
• **只读。**它可以查找信息，但无法进行任何更改。
• 适用于 Claude、ChatGPT、Cursor、VS Code、Claude Code 和其他支持 MCP 的应用。

什么是 MCP？

MCP（模型上下文协议）是一种为 AI 助手接入额外能力的标准。可以把它想象成一个电源适配器：接入后，你的助手就能替你查询 SaaS Puppy，而不是凭记忆猜测。

可以问什么？

连接后，可以用日常语言提问：

• “Neon 的免费方案包含什么？有什么限制？”
• “比较一下 Supabase 和 Neon，看看哪个更适合个人项目。”
• “给我推荐几个免费的托管方案。”
• “给我推荐几个免费的电子邮件工具，并告诉我哪些需要信用卡。”
• “有没有免费的开源运行时间监控方案？”

助手会选择合适的工具并显示答案。你不需要亲自调用这些工具。

设置

选择适合你的应用的方式。第一种最简单，因为无需安装任何东西。

简单方式：使用网址

使用此地址，无需身份验证：

https://saaspuppy.com/MCP

应用	操作方法
Claude（网页版和桌面版）	依次进入 Settings、Connectors，然后添加自定义连接器。粘贴地址并选择无需身份验证。
ChatGPT	添加自定义远程 MCP 连接（你的套餐支持时）。粘贴地址并选择无需身份验证。
Cursor	依次进入 Settings、MCP，然后使用该地址添加远程服务。
Claude Code	运行 claude mcp add --transport http saas-puppy https://saaspuppy.com/MCP
VS Code	查看 docs/clients.md。

更多应用（Hermes Agent、OpenClaw 等）请查看 docs/clients.md。应用菜单经常变化，如果某个步骤看起来不一样，请参照应用自己的 MCP 帮助，并使用上面的地址。

本地方式：在你的计算机上运行此软件包

有些应用仅支持本地服务。对于这些应用，请先安装 Node.js（20 或更高版本），然后将以下内容添加到应用的 MCP 设置中：

{
  "mcpServers": {
    "saas-puppy": {
      "command": "npx",
      "args": ["-y", "saas-puppy-mcp"]
    }
  }
}

对于 Claude Code：claude mcp add saas-puppy -- npx -y saas-puppy-mcp

检查是否正常运行

在你的计算机上运行：

npx -y saas-puppy-mcp --check

你应该会看到：

Checking the SaaS Puppy MCP at https://saaspuppy.com/MCP

PASS  Connected to the directory.
PASS  Found both tools: list_tools and compare_tools.
PASS  Asked a test question and got an answer.

All good. Your AI app can use this server.

如果某一行显示 FAIL，它也会告诉你接下来可以尝试什么。

常见问题

真的免费吗？ 是的。无需管理账号、密钥或使用限额。托管地址由所有人共享，因此有合理使用限制；如果有人发送过多请求，服务可能会变慢。

它能看到我的文件或聊天记录吗？ 不能。它只会接收助手发送的查询（例如“Neon”），然后返回答案。它不持有任何密钥，不读取任何文件，也没有自己的分析功能。

为什么它不列出所有工具？ 这是有意为之。完整目录位于 saaspuppy.com。助手可以查询某个工具、某个类别中的几个示例，或比较两三个工具。它会拒绝导出或逐页浏览所有内容的请求。

“暂时不可用”是什么意思？ 该软件包无法连接到 saaspuppy.com。等一分钟后再试。如果问题持续出现，请运行上面的检查。

数据来自哪里？ 来自 SaaS Puppy 实时目录。每个答案都包含该条目最近一次验证的日期。价格和限额会变化，因此在依赖某个数值之前，请先打开链接页面。

npx 提示“command not found”。 请从 nodejs.org 安装 Node.js（LTS 版本即可），然后重新启动应用。

还有其他问题。 提交 issue，并粘贴 --check 的输出。

两种工具

工具	返回内容
list_tools	按确切名称或 slug 查询某个工具的简短摘要，或查看某个类别中最多三个示例。可按 free-forever、free-trial、open-source 或 self-hosted 筛选。
compare_tools	并排展示同一类别中两三个工具的摘要。

每份摘要都包含工具的用途、最多三个优点和三个缺点、注意事项、免费套餐摘要、定价模式、试用天数、是否需要银行卡、最近一次验证的日期，以及 SaaS Puppy 页面 URL。

---

面向开发者

工作原理

该软件包是一个小型代理。它会在本地定义这两种工具，其名称、输入架构和说明均与托管的公共 MCP 相同，因此客户端和注册表无需网络调用即可列出它们。运行工具时，软件包会将请求转发到托管端点并返回答案。

• 没有机密信息，也不访问数据库。 所有数据和限额都由 SaaS Puppy 服务端管理。
• 唯一可信数据源。 条目、验证日期和速率限制均来自网站，因此软件包不会提供过时数据。
• 故障时优雅降级。 如果无法连接托管端点，工具会返回指向 saaspuppy.com 的纯文本错误，而不会导致客户端崩溃。
• 本地防护。 批量、通配符和分页请求会在离开你的设备之前被拒绝。

运行模式

npx -y saas-puppy-mcp                     # stdio (default)
npx -y saas-puppy-mcp --http --port 8080  # Streamable HTTP at /mcp, health check at /healthz
npx -y saas-puppy-mcp --check             # self-test

HTTP 模式是无状态的，因此可在任何负载均衡器后运行。软件包中包含 Dockerfile：

docker build -t saas-puppy-mcp .
docker run --rm -p 8080:8080 saas-puppy-mcp

配置

设置	标志	环境变量	默认值
上游公共 MCP	--endpoint	SAAS_PUPPY_MCP_URL	https://saaspuppy.com/MCP
上游超时（毫秒）	--timeout	SAAS_PUPPY_MCP_TIMEOUT_MS	20000
HTTP 端口（搭配 --http）	--port	PORT	8080
HTTP 绑定地址	--host	无	0.0.0.0

上游地址必须使用 https。仅在开发时允许对 localhost 使用普通 http。

开发

npm install
npm run check     # typecheck, build and test in one go

测试使用托管端点的模拟版本，因此无需联网。

文件	用途
src/server.ts	构建 MCP 服务并注册两种工具。
src/tools.ts	工具名称、说明和输入架构。
src/lookup.ts	批量请求防护的本地副本。
src/remote.ts	托管端点的客户端，支持重新连接和超时。
src/http.ts	无状态的 Streamable HTTP 服务。
src/check.ts	--check 自检。
src/cli.ts	命令行入口。

请参阅 CONTRIBUTING.md 了解如何提交更改。

发布

维护者：docs/launch-guide.md 是一份使用通俗英语编写的逐步发布检查清单，docs/publishing.md 介绍了注册表的详细信息。

许可证

MIT。SaaS Puppy 列表数据归 SaaS Puppy 所有，并按照 saaspuppy.com 上的条款提供。