Hn Server

🚀 Hacker News MCP サーバー

このサーバーは、Hacker Newsからストーリーを取得するツールを提供するモデルコンテキストプロトコル（MCP）サーバーです。news.ycombinator.comのHTMLコンテンツを解析し、様々なタイプのストーリー（人気、最新、質問、展示、求人）に対する構造化データを提供します。

✨ 主な機能

• 様々なタイプのストーリー（人気、最新、質問、展示、求人）を取得できます。
• タイトル、URL、得点、作者、タイムスタンプ、コメント数などの構造化データを取得できます。
• 返されるストーリーの数量を制限する設定が可能です。
• 明確なエラー処理とバリデーションが行われます。

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/pskill9/hn-server
cd hn-server

2. 依存関係をインストールします：

npm install

3. サーバーをビルドします：

npm run build

4. これをあなたのMCP設定構成ファイルに追加します（具体的な場所はシステムによって異なります）：

VSCode Claude拡張機能の場合：

{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

💻 使用例

このサーバーは、Hacker Newsからストーリーを取得する get_stories というツールを提供しています。

基本的な使用法

ツール：get_stories

パラメータ：

• type (文字列)：取得するストーリーのタイプ
  • 選択可能な値：'top', 'new', 'ask', 'show', 'jobs'
  • デフォルト値：'top'
• limit (数値)：返されるストーリーの数量
  • 範囲：1-30
  • デフォルト値：10

使用例：

use_mcp_tool with:
server_name: "hacker-news"
tool_name: "get_stories"
arguments: {
  "type": "top",
  "limit": 5
}

サンプル出力：

[
  {
    "title": "示例故事标题",
    "url": "https://example.com/story",
    "points": 100,
    "author": "用户名",
    "time": "2024-12-28T00:03:05",
    "commentCount": 50,
    "rank": 1
  },
  // ... 他のストーリー
]

📚 ドキュメント

Claudeへの統合

このMCPサーバーをClaudeと一緒に使用するには、以下の手順が必要です：

1. ClaudeデスクトップアプリまたはVSCode Claude拡張機能をインストールします。
2. 設定でMCPサーバーを構成します。
3. Claudeの自然言語インターフェースを使ってHacker Newsとやり取りします。

構成

Claudeデスクトップアプリの場合：

{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

エラー処理

このサーバーには堅牢なエラー処理が含まれており、以下のようなエラーに対応しています：

• 無効なストーリータイプ
• ネットワーク障害
• HTML解析エラー
• 無効なパラメータ値

エラーは適切なエラーコードと説明メッセージで返されます。

コントリビューション

コントリビューションを歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

MITライセンス - あなたのプロジェクトで自由に使用できます。