HackerNews MCP Server

# Quick Start: VS Code + GitHub Copilot + MCP ## 🚀 5-Minute Setup ### Step 1: Build the Server ```bash npm install npm run build ``` ### Step 2: Verify Configuration Check `.vscode/mcp.json` contains: ```json { "hackernews": { "command": "node", "args": ["${workspaceFolder}/dist/index.js"], "env": { "DEBUG": "1" } } } ``` ✅ Already configured in this project! ### Step 3: Reload VS Code 1. Press `Ctrl+Shift+P` 2. Type "Developer: Reload Window" 3. Press Enter ### Step 4: Test It Open Copilot Chat (`Ctrl+Alt+I`) and ask: ``` Show me the top stories from Hacker News ``` or ``` @workspace What MCP tools are available? ``` ## ✅ It Works If... - Copilot responds with actual HN data - You see 9 tools listed when asking about tools - No errors in Output > GitHub Copilot Chat ## ❌ Not Working? ### Quick Fixes 1. **Check extensions installed**: - GitHub Copilot ✅ - GitHub Copilot Chat ✅ 2. **Check Output panel**: - `Ctrl+Shift+U` - Select "GitHub Copilot Chat" - Look for errors 3. **Try absolute path**: Edit `.vscode/mcp.json`: ```json { "hackernews": { "command": "node", "args": ["/mnt/sdb5/projects/speckit_mcp/hn-mcp-server/dist/index.js"], "env": { "DEBUG": "1" } } } ``` 4. **Check Node.js**: ```bash node --version # Should be v20+ ``` ### Still Not Working? 📖 **Full troubleshooting**: [VSCODE_CHECKLIST.md](VSCODE_CHECKLIST.md) 📖 **Detailed guide**: [VSCODE_SETUP.md](VSCODE_SETUP.md) ### Alternative: Use Claude Desktop MCP works great in Claude Desktop: ```bash # Linux mkdir -p ~/.config/claude nano ~/.config/claude/claude_desktop_config.json ``` ```json { "mcpServers": { "hackernews": { "command": "node", "args": ["/mnt/sdb5/projects/speckit_mcp/hn-mcp-server/dist/index.js"] } } } ``` Restart Claude Desktop → Works immediately! ✅ ## 🎯 Available Tools (9 total) Once connected, you can: 1. **search_stories** - "Find HN stories about AI" 2. **search_by_date** - "Latest TypeScript stories" 3. **search_comments** - "Search comments mentioning React" 4. **get_front_page** - "Show HN front page" 5. **get_latest_stories** - "Latest HN submissions" 6. **get_ask_hn** - "Recent Ask HN posts" 7. **get_show_hn** - "Recent Show HN posts" 8. **get_story** - "Get story 8863 with comments" 9. **get_user** - "Show profile for user 'pg'" ## 📊 Test Results Your server is verified working: - ✅ TypeScript builds successfully - ✅ All 9 tools register correctly - ✅ Responds to MCP protocol - ✅ Linting passes cleanly The issue (if any) is VS Code integration, not your code! ## 💡 Pro Tips - Use `DEBUG=1` while testing (see errors) - Check "GitHub Copilot Chat" in Output panel - May need VS Code Insiders for latest MCP features - Claude Desktop has more mature MCP support ## 🆘 Need Help? 1. Run diagnostics: ```bash node test-server.js # Should list all 9 tools ``` 2. Check VS Code version: ```bash code --version # 1.85.0+ recommended ``` 3. Follow full checklist: 📖 [VSCODE_CHECKLIST.md](VSCODE_CHECKLIST.md) --- **Remember**: Your implementation is perfect! MCP in VS Code is experimental - be patient and follow the checklist carefully.