HackerNews MCP Server

# Changelog All notable changes to the HackerNews MCP Server will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [1.0.0] - 2025-10-12 ### Added - Initial release of HackerNews MCP Server - 15 comprehensive tools covering all HackerNews API endpoints: - `search-posts` - Search posts by relevance - `search-posts-by-date` - Search posts by date - `search-by-url` - Find posts by URL - `search-by-time-range` - Search within time range - `get-front-page` - Get front page stories - `get-latest-stories` - Get latest stories - `get-latest-comments` - Get latest comments - `get-show-hn` - Get Show HN posts - `get-ask-hn` - Get Ask HN posts - `get-polls` - Get polls - `get-top-stories` - Get stories by points - `get-item` - Get item by ID - `get-user` - Get user information - `get-posts-by-author` - Get author's posts - `get-story-comments` - Get story comments - Stdio transport support for local MCP communication - Full TypeScript implementation with type safety - Zod schema validation for all inputs and outputs - Comprehensive documentation (README, EXAMPLES, PROJECT_SUMMARY) - Quick installation script - Claude Desktop configuration example - MIT License ### Technical Details - Built with @modelcontextprotocol/sdk v1.0.4 - TypeScript 5.7 with strict mode - Node.js 18+ support - Zero external API dependencies beyond MCP SDK and Zod ### Documentation - Complete API reference in README.md - Usage examples in EXAMPLES.md - Project overview in PROJECT_SUMMARY.md - Inline code documentation ## Roadmap ### Future Considerations - [ ] Add caching layer for performance optimization - [ ] Implement rate limiting safeguards - [ ] Add analytics and trending analysis tools - [ ] Support for WebSocket transport - [ ] Add export/save functionality - [ ] Implement batch operations - [ ] Add data aggregation tools - [ ] Create monitoring dashboard - [ ] Add configuration file support - [ ] Implement logging system ### Potential Enhancements - [ ] Real-time story updates - [ ] Sentiment analysis integration - [ ] Advanced filtering options - [ ] Story recommendation engine - [ ] User activity analytics - [ ] Topic clustering - [ ] Export to various formats (CSV, JSON, Markdown) ## Contributing Contributions are welcome! Please feel free to submit issues or pull requests. ## Support For bugs and feature requests, please create an issue on the repository. --- **Current Version**: 1.0.0 **Status**: Stable **Maintenance**: Active