# Features in reddit-mcp-buddy not present in hn-mcp
This document tracks features and files present in reddit-mcp-buddy that are not currently implemented in hn-mcp. These are potential enhancements to consider for future development.
## 📝 Documentation & Developer Files
1. **CLAUDE.md** - Comprehensive developer guide with:
- Publishing workflows
- Troubleshooting guides
- Version history
- Development best practices
2. **CONTRIBUTING.md** - Contribution guidelines for open source contributors
3. **server.json** - MCP Registry metadata file for publishing to MCP registry
4. **.env.example** - Example environment variables file for developers
## 🔐 Authentication System
5. **auth.ts** - Complete OAuth authentication manager
- Note: HN doesn't need this as the API is completely open
- Reddit has 3-tier auth (anonymous/app-only/full)
## 🧪 Testing Infrastructure
6. **Vitest test suite** - Full testing framework with:
- `test` command
- `test:coverage` for code coverage reports
7. **Rate limit test scripts**:
- `test-rate-limit-simple.py` - Python rate limit tester
- `test-rate-limits.js` - Node.js rate limit tester
- `test-rate-limits.sh` - Shell script rate limit tester
- `scripts/rate-limit-tester.cjs` - CommonJS rate limit tester
8. **Test commands in package.json**:
- `test:rate-limit:anon` - Test anonymous rate limits
- `test:rate-limit:app` - Test app-only rate limits
- `test:rate-limit:auth` - Test authenticated rate limits
## 🐳 Deployment & Infrastructure
9. **Dockerfile** - For containerized deployment with multi-stage build
10. **Docker commands in package.json**:
- `docker:build` - Build Docker image
- `docker:run` - Run Docker container
- `docker:run-http` - Run Docker container in HTTP mode
11. **smithery.yaml** - Smithery deployment configuration
12. **deploy-server.sh** - Automated deployment script
## 🛠️ Development Tools
13. **content-processor.ts** - Content processing utilities for text manipulation
14. **mcp.types.ts** - MCP-specific type definitions (separate from service types)
15. **ESLint configuration** - Code linting with `lint` command configured
16. **Vitest dev dependencies** - Testing framework dependencies
17. **prepublishOnly hook** - Ensures build runs before npm publish
## 📦 NPM Package Metadata
18. **mcpName field** in package.json - MCP registry package name
19. **Multiple bin entries** - Both short and long forms (e.g., `reddit-buddy` and `reddit-mcp-buddy`)
20. **More comprehensive scripts section** - Additional utility scripts
## 🎯 MCP Registry Publishing
21. **MCP Registry workflow** in GitHub Actions - More comprehensive publishing workflow
22. **UUID tracking system** - Tracks version-specific UUIDs for MCP Registry
23. **Badge system** - Dynamic badges for MCP Registry listing
24. **Registry verification steps** - Automated verification after publishing
## 📊 Scripts Folder
25. **Dedicated scripts/ folder** containing:
- Rate limit tester
- README for scripts usage
- .env.example for script configuration
- .gitignore for script-specific files
## 🔧 CLI Features
26. **--auth flag** - Interactive authentication setup (Reddit-specific, not needed for HN)
27. **More robust CLI argument parsing** - Advanced command-line interface options
## Priority Implementation Suggestions
### High Priority (Would significantly improve hn-mcp)
- [ ] Add **server.json** for MCP Registry publishing
- [ ] Create **CLAUDE.md** developer documentation
- [ ] Add **Dockerfile** for containerized deployment
- [ ] Implement **Vitest test suite**
- [ ] Add **content-processor.ts** for text utilities
### Medium Priority (Nice to have)
- [ ] Add rate limit testing scripts
- [ ] Create CONTRIBUTING.md
- [ ] Add smithery.yaml for Smithery deployment
- [ ] Implement more comprehensive GitHub Actions
### Low Priority (Reddit-specific or optional)
- [ ] Authentication system (not needed for HN)
- [ ] Multiple bin entries (current single entry is sufficient)
- [ ] --auth CLI flag (not applicable to HN)
## Notes
Most missing features fall into three categories:
1. **Reddit-specific** - Authentication system and related features
2. **Infrastructure** - Docker, testing, deployment tools
3. **Documentation** - Developer guides and contribution docs
The core MCP functionality for Hacker News is complete and working. These missing features are primarily quality-of-life improvements and deployment options.
