Product Hunt MCP Server 是一个即插即用的 MCP（Model Context Protocol）服务器，旨在将 Product Hunt 的 API 连接到任何支持 MCP 的大语言模型或智能体。它适用于 AI 助手、聊天机器人或自定义自动化流程。
主要能力
- 获取 Product Hunt 上的帖子、收藏集、主题、用户等详细信息。
- 获取投票、评论等数据。
- 支持按主题、日期、票数等条件进行搜索和过滤。
- 支持分页获取评论、用户点赞等内容。
- 基于 FastMCP 构建，注重速度与兼容性。
使用方式
前置条件
需要 Product Hunt API 令牌。获取方式：在 Product Hunt 创建账户，进入 API Dashboard 并创建新应用，使用 Developer Token 作为令牌。创建应用时需填写 redirect_uri，虽然 MCP 服务器不使用该 URI，但它是必填项，可填写任意有效 URL，例如 https://localhost:8424/callback。
安装
推荐使用 uv（快速、现代的 Python 安装器）。安装后，product-hunt-mcp 命令将可用。
与 Claude Desktop 和 Cursor 配合使用
将 product-hunt-mcp 添加到 Claude Desktop 或 Cursor 的配置中，并将 your_token_here 替换为实际的 Product Hunt API 令牌。令牌必须作为环境变量在配置中设置，服务器才能进行身份验证。编辑配置文件后，务必重启客户端（Claude Desktop/Cursor）。
在 macOS 上，如果 Claude Desktop 找不到 product-hunt-mcp 命令（不在默认 PATH 中），可以安装后运行命令获取可执行文件的完整路径，并在配置中使用该完整路径替换 "command": "product-hunt-mcp"。
配置文件位置
- Claude Desktop：
- Windows: %APPDATA%\claude-desktop\config.json
- macOS: ~/Library/Application Support/claude-desktop/config.json
- Linux: ~/.config/claude-desktop/config.json
- Cursor：
- Windows: %APPDATA%\Cursor\User\settings.json
- macOS: ~/Library/Application Support/Cursor/User/settings.json
- Linux: ~/.config/Cursor/User/settings.json
Docker 运行
也可以使用 Docker 运行服务器。与 Claude Desktop/Cursor 集成时，使用相应的 Docker 配置。
安全提示：PRODUCT_HUNT_TOKEN 是敏感信息，请勿分享或提交到版本控制。
适用场景
- AI/LLM 用户：接入 Claude Desktop、Cursor 或自己的智能体。
- 开发者：利用 Product Hunt 数据构建机器人、仪表盘或自动化工具。
- 爱好者：探索 MCP 生态并构建自己的工具。
限制与注意事项
- Product Hunt API 存在速率限制，此客户端会遵守这些限制。如果遇到速率限制错误，客户端会告知何时重置。可以使用 get_api_rate_limits 或 check_server_status 工具检查当前速率限制状态。
- 常见问题排查：缺少令牌时确保 PRODUCT_HUNT_TOKEN 已正确设置为环境变量；连接问题需检查网络连接及 Product Hunt API 可访问性；速率限制需等待重置或降低查询频率；客户端找不到服务器需验证 Python 可执行文件路径并重启客户端。
- 该项目与 Product Hunt 无关联，Product Hunt API 可能会发生变化。
- 欢迎提交 PR 和 issue，请遵循 PEP8 并使用 ruff 进行代码检查，开发依赖见 pyproject.toml。
