Hackernews MCP

🚀 📰 Hacker News MCP Server

このサーバーは、Hacker Newsのコンテンツを取得して対話するためのツールを提供するModel Context Protocol (MCP) サーバーです。AIアシスタントが、トップストーリー、ストーリーの詳細、コメント、検索機能を含むリアルタイムのHacker Newsデータにアクセスできるようになります。

🚀 クイックスタート

このサーバーを使用することで、AIアシスタントがHacker Newsのコンテンツにアクセスできるようになります。以下の手順に従ってサーバーをセットアップしてください。

✨ 主な機能

🛠️ 利用可能なツール

• get_top_stories - Hacker Newsの最新のトップストーリーを取得します。

  • 取得するストーリーの数を設定できます (1 - 100件)
  • オプションでテキストコンテンツを含めることができます
  • タイトル、URL、スコア、著者、コメント数を含むストーリーのメタデータを返します

• get_story_details - 特定のストーリーの詳細情報を取得します。

  • 完全なストーリーのメタデータを取得します
  • オプションでスレッド構造のコメントを含めることができます
  • オプションでリンクされた記事からMarkdownコンテンツを抽出できます

• get_story_comments - ストーリーの人気コメントを取得します。

  • 最小スコアでフィルタリングできます
  • コメントのスレッド深度を調整できます (1 - 10レベル)
  • 返されるコメントの数を制限できます (1 - 100件)
  • スレッド構造を持つ読みやすいテキスト形式で返されます

• search_stories - キーワードで最近のストーリーを検索します。

  • ストーリーのタイトル、コンテンツ、URLを検索します
  • 検索する時間範囲を設定できます (1 - 168時間)
  • 検索結果の数を制限できます (1 - 50件)

📦 インストール

1. リポジトリをクローンする

git clone https://github.com/yourusername/hackernews-mcp.git
cd hackernews-mcp

2. 依存関係をインストールする

npm install

3. サーバーをビルドする

npm run build

💻 使用例

基本的な使用法

Claude Desktopを使用する場合、以下のようにサーバーを設定します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hackernews-mcp": {
      "command": "node",
      "args": ["/path/to/hackernews-mcp/build/index.js"]
    }
  }
}

高度な使用法

他のMCP互換クライアントを使用する場合、サーバーはstdioを介して通信します。

node build/index.js

接続後、AIアシスタントに以下のような質問をすることができます。

• "今日のHacker Newsのトップストーリーは何ですか？"
• "Hacker Newsのストーリー12345678の詳細を取得してください"
• "その話題のAIストーリーのコメントを見せてください"
• "最近のTypeScriptに関するストーリーを検索してください"

📚 ドキュメント

サーバーの開発

プロジェクトをビルドする

npm run build

開発用のウォッチモードを起動する

npm run watch

コードのリントとフォーマットを行う

npm run lint
npm run format

MCPインスペクターを実行する

デバッグとテストのために、以下のコマンドを実行します。

npm run inspector

これにより、サーバーのツールをテストし、通信を検査するためのWebインターフェースが提供されます。

コード品質とコントリビューション

• コード品質:
  このプロジェクトでは、ESLint と Prettier を使用してコード品質とスタイルを管理しています。すべてのコードはCI (GitHub Actions) でチェックされ、マージする前にリントとフォーマットを通過する必要があります。
• 型安全性:
  すべてのツールハンドラーは、ランタイム引数の検証に明示的な型ガードを使用し、堅牢なTypeScript型を使用しています。
• CI/CD:
  すべてのプッシュとプルリクエストは、GitHub Actionsを介して完全なビルド、リント、および (将来的には) テストスイートを実行します。
• コントリビューションの方法:
  1. リポジトリをフォークします
  2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)
  3. 変更をコミットします (git commit -m 'Add amazing feature')
  4. プッシュする前に npm run lint と npm run format を実行します
  5. ブランチにプッシュします (git push origin feature/amazing-feature)
  6. プルリクエストを作成します

APIリファレンス

get_top_stories

{
  count?: number;        // 取得するストーリーの数 (1 - 100件、デフォルト: 30件)
  include_text?: boolean; // ストーリーのテキストコンテンツを含めるかどうか (デフォルト: false)
}

get_story_details

{
  story_id: number;           // 必須: Hacker NewsのストーリーID
  include_comments?: boolean; // コメントを含めるかどうか (デフォルト: false)
  include_markdown?: boolean; // 記事をMarkdown形式で抽出するかどうか (デフォルト: false)
}

get_story_comments

{
  story_id: number;    // 必須: Hacker NewsのストーリーID
  min_score?: number;  // コメントの最小スコア (デフォルト: 1)
  max_depth?: number;  // コメントの最大スレッド深度 (1 - 10、デフォルト: 3)
  limit?: number;      // 返されるコメントの最大数 (1 - 100件、デフォルト: 20件)
}

search_stories

{
  query: string;              // 必須: 検索キーワード
  limit?: number;             // 検索結果の最大数 (1 - 50件、デフォルト: 20件)
  time_range_hours?: number;  // 検索する時間範囲 (1 - 168時間、デフォルト: 24時間)
}

アーキテクチャ

このサーバーは以下の技術で構築されています。

• TypeScript - 型安全性と開発者体験の向上のため
• @modelcontextprotocol/sdk - MCPプロトコルの実装
• axios - Hacker News APIへのHTTPリクエスト
• jsdom と turndown - HTMLをMarkdownに変換するため
• private-ip - セキュリティのため (プライベートIPアドレスへのアクセスをブロック)

主要なコンポーネント

• src/index.ts - ツールハンドラーを含むメインサーバーの実装
• src/fetcher.ts - Webコンテンツの取得と変換のためのユーティリティクラス
• build/ - コンパイルされたJavaScript出力 (自動生成)

セキュリティ

• プライベートIPアドレスへのリクエストをブロックし、ローカルネットワークへのアクセスを防止します
• Hacker News APIの自然な制限によるレート制限
• すべてのツールパラメータの入力検証
• エラーハンドリングと適切な劣化

📄 ライセンス

このプロジェクトはMITライセンスのもとで公開されています。詳細は LICENSE ファイルを参照してください。

🙏 謝辞

• Hacker News - 優れたAPIを提供してくれた
• Model Context Protocol - 標準を提供してくれた
• オープンソースコミュニティ - 素晴らしいツールとライブラリを提供してくれた

📞 サポート

問題が発生した場合や質問がある場合は、以下の手順に従ってください。

1. Issues ページを確認します
2. デバッグのためにMCPインスペクターを使用します: npm run inspector
3. 問題の詳細情報を含めて新しいIssueを作成します

Made with ❤️ for the MCP community