README.md•2.41 kB
# Hacker News MCP Server
A FastMCP server that provides access to Hacker News data for Poke integration.
## 🚀 Features
- **get_top_stories**: Fetch top stories from Hacker News
- **get_story**: Get details of a specific story by ID
- **get_new_stories**: Fetch newest stories
- **search_stories**: Search for stories using Algolia API
## 🛠️ Local Development
```bash
# Install dependencies
pip install -r requirements.txt
# Run the server
python src/server.py
```
## 🚢 Deployment
### Deploy to Render
[](https://render.com/deploy)
**Steps:**
1. **Click the "Deploy to Render" button above** or go to [render.com](https://render.com)
2. **Connect your GitHub account to Render** (if you haven't already)
3. **Create a new Web Service:**
- Connect this repository
- **Name**: `hackernews-mcp`
- **Environment**: `Python 3`
- **Plan**: `Free`
- **Build Command**: `pip install -r requirements.txt`
- **Start Command**: `python src/server.py`
4. **Deploy!** (No additional environment variables needed - uses public Hacker News API)
> Note: On Render's free tier, services go idle after ~15 minutes of inactivity and may require a manual "Deploy" to wake or to pick up the latest commit. Unlike Vercel, pushes do not auto-deploy by default.
Your server will be available at `https://hackernews-mcp.onrender.com/mcp`
## 🎯 Poke Integration
1. Go to [poke.com/settings/connections](https://poke.com/settings/connections)
2. Add the MCP URL: `https://hackernews-mcp.onrender.com/mcp`
3. Give it a name like "Hacker News"
4. Try: "Can you use the Hacker News MCP to get top stories?"
## References
- Based on the Interaction MCP server template: [MCP Server Template](https://github.com/InteractionCo/mcp-server-template/tree/main)
- Discovered via Interaction’s HackMIT challenge: [Interaction HackMIT Challenge](https://interaction.co/HackMIT)
## 🔧 Available Tools
- `get_top_stories(limit=10)`: Get top stories (max 30)
- `get_story(story_id)`: Get specific story details
- `get_new_stories(limit=10)`: Get newest stories (max 30)
- `search_stories(query, limit=10)`: Search stories (max 20)
## 📝 Example Usage
```python
# Get top 5 stories
get_top_stories(limit=5)
# Get story details
get_story(story_id=12345)
# Search for Python stories
search_stories(query="python", limit=5)
```