使用说明

项目简介

Product Hunt MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在将 Product Hunt API 的数据以标准化的方式提供给大型语言模型 (LLM) 客户端，例如 Claude Desktop 和 Cursor。通过此服务器，用户可以使用 LLM 方便地获取 Product Hunt 上的产品、用户、评论等信息，从而扩展 LLM 的知识库和功能。

主要功能点

数据访问: 提供对 Product Hunt 平台上的帖子 (Posts)、评论 (Comments)、专题 (Topics)、用户 (Users) 和合集 (Collections) 等资源的访问能力。
工具集成: 内置多种 MCP 工具，允许 LLM 客户端通过标准化的方式调用，例如：
- 获取帖子详情 (get_post_details)
- 获取帖子列表 (get_posts)
- 获取评论详情 (get_comment)
- 获取帖子评论 (get_post_comments)
- 获取合集信息 (get_collection, get_collections)
- 获取专题信息 (get_topic, search_topics)
- 获取用户信息 (get_user, get_viewer)
- 服务器状态检查 (check_server_status)
灵活的查询参数: 支持丰富的查询参数，如按主题、日期、投票数等过滤帖子，以及分页、排序等功能。
易于集成: 可以轻松集成到任何支持 MCP 协议的 LLM 客户端，如 Claude Desktop 和 Cursor。
基于 FastMCP: 构建于 FastMCP 框架之上，保证了速度和兼容性。

安装步骤

环境准备: 确保已安装 Python 3.10 或更高版本。
获取 Product Hunt API Token: 访问 Product Hunt 开发者页面创建应用并获取 'Developer Token'，此 Token 用于服务器访问 Product Hunt API。

安装 Product Hunt MCP Server: 使用 pip 或 uv 包管理器进行安装：

pip install product-hunt-mcp
# 或使用 uv (推荐):
uv pip install product-hunt-mcp

服务器配置

要将 Product Hunt MCP Server 集成到 MCP 客户端（如 Claude Desktop 或 Cursor），您需要配置客户端的 MCP 服务器设置。以下是配置示例（JSON 格式）：

{
  "mcpServers": {
    "product-hunt": {  // 服务器名称，可以自定义
      "command": "product-hunt-mcp",  // 启动服务器的命令
      "env": {
        "PRODUCT_HUNT_TOKEN": "your_token_here"  // Product Hunt API Token 环境变量
      }
    }
  }
}

配置参数说明:

'"product-hunt"': 服务器名称，在客户端配置中用于标识该服务器，可以自定义。
'"command": "product-hunt-mcp"': 启动 Product Hunt MCP Server 的命令。安装成功后，'product-hunt-mcp' 命令会自动添加到您的系统路径中。
'"env": { "PRODUCT_HUNT_TOKEN": "your_token_here" }"': 配置环境变量，'PRODUCT_HUNT_TOKEN' 必须设置为您从 Product Hunt 开发者页面获取的 API Token，请将 '"your_token_here"' 替换为您的实际 Token。

注意:

请务必将 'PRODUCT_HUNT_TOKEN' 替换为您自己的 API Token。
环境变量 'PRODUCT_HUNT_TOKEN' 是服务器运行所必需的，用于鉴权访问 Product Hunt API。
配置完成后，请重启您的 MCP 客户端 (Claude Desktop 或 Cursor) 使配置生效。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您可以通过调用已注册的 MCP 工具来访问 Product Hunt 数据。例如，您可以使用 'get_posts' 工具来获取最新的 Product Hunt 帖子列表，或使用 'get_post_details' 工具获取特定帖子的详细信息。

具体的工具列表及其参数，请参考仓库 'README.md' 文档中的 "🛠️ MCP Tools" 章节。在 LLM 客户端中，您可以像调用其他工具一样调用这些 Product Hunt 相关的工具，从而实现与 Product Hunt 数据的交互。

例如，在 Claude Desktop 或 Cursor 中，您可以指示 LLM 使用 'product-hunt/get_posts' 工具来获取 Product Hunt 的最新产品，并要求 LLM 对返回的结果进行分析或总结。

关键词