🚀 Product Hunt MCP Server

🚀 Product Hunt MCP サーバー

Product Hunt 向けのプラグアンドプレイ MCP サーバー

---

📦 クイックインストール

pip install product-hunt-mcp

🏃‍♂️ クイックスタートの例

# Run the MCP server (requires PRODUCT_HUNT_TOKEN environment variable)
export PRODUCT_HUNT_TOKEN=your_token_here
product-hunt-mcp

---

✨ これは何ですか？

Product Hunt MCP Server は、Product Hunt の API を、Model Context Protocol（MCP） に対応するあらゆる LLM やエージェントに接続します。AI アシスタント、チャットボット、独自の自動化に最適です！

• 🔍 投稿、コレクション、トピック、ユーザーを取得
• 🗳️ 投票、コメントなどを取得
• 🛠️ Claude Desktop、Cursor、その他の MCP クライアントで使用

---

🛠️ 機能

• 投稿、コメント、コレクション、トピック、ユーザーの詳細情報を取得
• トピック、日付、投票数などで検索・フィルタリング
• ページ分割されたコメント、ユーザーの高評価などに対応
• 高速性と互換性を実現するため、FastMCP を使用して構築

---

🧑‍💻 対象ユーザー

• AI／LLM ユーザー：Claude Desktop、Cursor、または独自のエージェントに接続できます
• 開発者：Product Hunt のデータを使って、ボット、ダッシュボード、自動化を構築できます
• 試してみたい方：MCP エコシステムを探り、独自のツールを構築できます

---

🏁 セットアップ

前提条件

• Python 3.10+
• Product Hunt API トークン（こちらから取得）
  • Product Hunt でアカウントを作成する必要があります
  • API ダッシュボードに移動し、新しいアプリケーションを作成します
  • トークンには Developer Token を使用します

注記： Product Hunt で新しいアプリケーションを作成する際、redirect_uri の入力を求められます。MCP サーバーではリダイレクト URI を使用しませんが、必須項目です。https://localhost:8424/callback など、有効な URL を入力してください。

インストール

推奨：uv（高速でモダンな Python インストーラー）

# Install uv if you don't have it
pip install uv

PyPI からインストール（推奨）

uv pip install product-hunt-mcp
# or
pip install product-hunt-mcp

GitHub からインストール（最新の main ブランチ）

uv pip install 'git+https://github.com/jaipandya/producthunt-mcp-server.git'
# or
pip install 'git+https://github.com/jaipandya/producthunt-mcp-server.git'

ソースからローカルにインストール

uv pip install .
# or
pip install .

---

🚀 Claude Desktop と Cursor での使用

インストールすると、product-hunt-mcp コマンドを使用できるようになります。Claude Desktop または Cursor の設定に追加してください。

{
  "mcpServers": {
    "product-hunt": {
      "command": "product-hunt-mcp",
      "env": {
        "PRODUCT_HUNT_TOKEN": "your_token_here"
      }
    }
  }
}

• your_token_here を実際の Product Hunt API トークンに置き換えてください。
• サーバーが認証できるように、トークンを Claude Desktop または Cursor の設定で環境変数として設定する必要があります。
• 設定ファイルを編集した後は、必ずクライアント（Claude Desktop／Cursor）を再起動してください。

ヒント： macOS では、product-hunt-mcp がデフォルトの PATH に含まれていない場合、Claude Desktop がコマンドを見つけられないことがあります。問題が発生した場合は、実行ファイルのフルパスを指定できます。インストール後、次のコマンドを実行してください。

which product-hunt-mcp

出力されたパスを Claude Desktop の設定で使用し、"command": "product-hunt-mcp" をフルパス（例："command": "/Users/youruser/.local/bin/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 を使ってサーバーを実行することもできます。

# Build the Docker image
docker build -t product-hunt-mcp .

# Run the Docker container (interactive for MCP)
docker run -i --rm -e PRODUCT_HUNT_TOKEN=your_token_here product-hunt-mcp

Docker で Claude Desktop／Cursor と連携するには、次の設定を使用してください。

{
  "mcpServers": {
    "product-hunt": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PRODUCT_HUNT_TOKEN=your_token_here", "product-hunt-mcp"],
      "env": {}
    }
  }
}

セキュリティに関する注意： PRODUCT_HUNT_TOKEN は機密情報です。他者と共有したり、バージョン管理にコミットしたりしないでください。

---

🛠️ MCP ツール

ツール	説明	主なパラメーター
get_post_details	特定の投稿に関する情報を取得します	id or slug, comments_count, comments_after
get_posts	フィルターを指定して投稿を取得します	topic, order, count, featured, posted_before, posted_after
get_comment	特定のコメントに関する情報を取得します	id (required)
get_post_comments	投稿のコメントを取得します	post_id or slug, order, count, after
get_collection	コレクションに関する情報を取得します	id or slug
get_collections	フィルターを指定してコレクションを取得します	featured, user_id, post_id, order, count
get_topic	トピックに関する情報を取得します	id or slug
search_topics	トピックを検索します	query, followed_by_user_id, order, count
get_user	ユーザーに関する情報を取得します	id or username, posts_type, posts_count
get_viewer	認証済みユーザーに関する情報を取得します	None
check_server_status	サーバー/API のステータスと認証を確認します	None

---

🏗️ プロジェクト構成

product-hunt-mcp/
├── src/
│   └── product_hunt_mcp/ # Main package directory
│       ├── __init__.py
│       ├── cli.py        # Command-line entry point
│       ├── api/          # API clients & queries
│       ├── schemas/      # Data validation schemas
│       ├── tools/        # MCP tool definitions
│       └── utils/        # Utility functions
├── pyproject.toml      # Project metadata, dependencies, build config
├── README.md
├── CONTRIBUTING.md
├── CHANGELOG.md
├── Dockerfile
└── ... (config files, etc.)

---

🔄 レート制限

Product Hunt API にはレート制限があり、このクライアントはその制限に従います。レート制限エラーが発生した場合、制限がリセットされる時刻をクライアントが通知します。get_api_rate_limits または check_server_status ツールを使って、現在のレート制限の状態を確認できます。

---

🐛 トラブルシューティング

• トークンが見つからない：PRODUCT_HUNT_TOKEN が環境変数として正しく設定されていることを確認してください。
• 接続の問題：インターネット接続と、Product Hunt API にアクセスできることを確認してください。
• レート制限：レート制限に達した場合は、リセット時刻まで待つか、クエリの頻度を下げてください。
• Claude Desktop/Cursor がサーバーを見つけられない：Python 実行ファイルへのパスを確認し、クライアントを再起動してください。

---

🤝 貢献

• PR とイシューを歓迎します！
• PEP8 に従い、リンティングには ruff を使用してください。
• 開発用の依存関係については pyproject.toml を参照してください。

---

🌐 リンク

• Model Context Protocol (MCP)
• FastMCP
• Product Hunt API ドキュメント
• MCP Inspector
• Awesome MCP Servers

---

📝 注記

• このプロジェクトは Product Hunt と提携していません。
• Product Hunt API は変更される場合があります。

---

📜 ライセンス

MIT