1. Conduid
  2. AI
  3. hn-server
MCP server · AI

hn-server

by · github.com/wei/hn-mcp-server

Model Context Protocol server for HackerNews API access

Unclaimed last commit 7 months ago mcpmodel-context-protocolhackernewshnapillmai
InstallView source
53Fair

Scored 19 days ago · breakdown

About hn-server

hn-server is an MCP server published by git+wei in the AI category: model Context Protocol server for HackerNews API access. It has been installed 0 times through Conduid.

The repository has 1 stars and 0 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx hn-mcp-server
Claude Code
claude mcp add hn-mcp-server -- npx -y hn-mcp-server
npx
npx -y hn-mcp-server
uvx
uvx hn-mcp-server
pip
pip install hn-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about hn-server

Powered by Claude · Grounded in docs

I know everything about hn-server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

hn-mcp-server

npm version Node.js Version MCP

Connect your AI assistant to HackerNews! This Model Context Protocol server gives Claude, GitHub Copilot, and other AI assistants the ability to search HN, read discussions, and explore user profiles.

✨ Features

  • 🔍 Search Posts - Find stories, comments, and discussions by keyword with advanced filters
  • 📰 Front Page - Access currently trending posts
  • 🆕 Latest Posts - Monitor newest content in real-time
  • 💬 Item Details - Retrieve full posts with nested comment trees
  • 👤 User Profiles - View author information, karma, and bios

🚀 Quick Start

Install in VS Code Install MCP Server

Other Clients

Add the following MCP server configuration to your client's MCP settings:

{
  "hn-mcp-server": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "hn-mcp-server"]
  }
}

📚 How to Use

Once configured, you can ask your AI assistant natural language questions like:

  • "What are the top stories on HackerNews right now?"
  • "Search HackerNews for discussions about Rust programming"
  • "Show me the latest AI-related posts with at least 100 points"
  • "Get the details and comments for HN item 38456789"
  • "What's the karma score for user 'pg'?"

The AI will automatically use the appropriate HackerNews tools to answer your questions.

🛠️ Available Tools

search-posts

Search HackerNews by keyword with filters for content type, points, and date range.

Example prompts:

  • "Search for stories about TypeScript"
  • "Find posts about AI with more than 200 points"
  • "Search for comments by author 'dang'"

get-front-page

Get the current HackerNews front page posts.

Example prompts:

  • "What's trending on HackerNews?"
  • "Show me the HN front page"

get-latest-posts

Get the most recent posts sorted by date.

Example prompts:

  • "What are the newest HackerNews stories?"
  • "Show me recent Ask HN posts"

get-item

Retrieve complete item details with nested comments.

Example prompts:

  • "Get HN item 38456789"
  • "Show me the discussion for this story"

get-user

View user profile information.

Example prompts:

  • "Tell me about HN user 'pg'"
  • "What's the karma for user 'tptacek'?"

🔧 Requirements

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

📖 Documentation

📄 License

MIT License - See LICENSE for details

🔗 Resources

README mirrored from the source repository 19 days ago. The original is authoritative.

Questions

About hn-server

How do I install hn-server?

Run npx hn-mcp-server, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is hn-server safe to use with an AI agent?

Its trust score is 53 out of 100 (fair). It passes 0 of 1 static security checks; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is hn-server still maintained?

The last commit was 7 months ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.