dev-context

README

Frontend News MCP - Real-time Query System

A production-ready MCP (Model Context Protocol) server providing real-time frontend development news aggregation and analysis.

Built using Claude Code PM system for spec-driven development with complete GitHub Issues traceability from requirements to production code.

🚀 Features

Core MCP Tools

• 📰 Weekly Frontend News - Curated weekly reports of frontend development news from multiple sources
• ⭐ Trending Repositories - GitHub trending analysis for frontend technologies and frameworks
• 🔍 Technical Topic Search - Intelligent search and analysis of specific frontend technologies

Enterprise Architecture

• 🏗️ Multi-layer Caching - High-performance Redis-backed caching with TTL and concurrency safety
• 📊 Concurrent Data Collection - Multi-source parallel data gathering (RSS/API/HTML)
• 🔄 Smart Data Processing - Intelligent scoring, deduplication, and content formatting
• 🐳 Production Deployment - Docker containerization with CI/CD and monitoring

📋 Table of Contents

• Quick Start
• MCP Tools
• Architecture
• Development
• Deployment
• API Documentation
• Project Management
• Contributing

🏁 Quick Start

Using Docker (Recommended)

# Clone the repository
git clone https://github.com/ZephyrDeng/dev-context.git
cd dev-context

# Start with Docker Compose
docker-compose up -d

# Check status
docker-compose ps

Local Development

# Navigate to the MCP server code
cd /Users/zephyr/mcp-servers/epic-mvp

# Install dependencies
go mod tidy

# Run locally
make run-dev

# Or build and run
make build
./bin/github.com/ZephyrDeng/dev-context

🛠 MCP Tools

1. Weekly Frontend News (weekly_news)

Aggregates and curates frontend development news from multiple sources.

Parameters:

• startDate - Start date for news collection (optional, defaults to 7 days ago)
• endDate - End date (optional, defaults to today)
• category - Filter by technology (react, vue, angular, etc.)
• minQuality - Minimum quality score (0.0-1.0, default 0.5)
• maxResults - Maximum results (default 50, max 200)

Example Usage:

{
  "name": "weekly_news",
  "arguments": {
    "category": "react",
    "minQuality": 0.7,
    "maxResults": 30
  }
}

2. Trending Repositories (trending_repos)

Analyzes GitHub trending repositories for frontend technologies.

Parameters:

• language - Programming language filter (javascript, typescript, etc.)
• timeRange - Time range (daily, weekly, monthly)
• minStars - Minimum star count (default 10)
• maxResults - Maximum results (default 30, max 100)

Example Usage:

{
  "name": "trending_repos",
  "arguments": {
    "language": "typescript",
    "timeRange": "weekly",
    "minStars": 100
  }
}

3. Technical Topic Search (topic_search)

Intelligent search and analysis of specific frontend technologies.

Parameters:

• topic - Technology or topic to search
• sources - Comma-separated list of sources
• depth - Search depth (shallow, moderate, deep)
• maxResults - Maximum results (default 20, max 100)

Example Usage:

{
  "name": "topic_search",
  "arguments": {
    "topic": "Next.js 15",
    "depth": "moderate",
    "maxResults": 25
  }
}

🏗 Architecture

System Components

Frontend News MCP Server
├── 🌐 MCP Protocol Layer (Go SDK v0.4.0)
├── 🛠️ Core Tools
│   ├── weekly_news      # Frontend news aggregation
│   ├── trending_repos   # GitHub trending analysis
│   └── topic_search     # Technical topic search
├── 📊 Data Processing
│   ├── Multi-source collection (RSS/API/HTML)
│   ├── Content processing & scoring
│   └── Format conversion (JSON/Markdown/Text)
├── 💾 Caching Layer
│   ├── Redis backend
│   ├── TTL management
│   └── Concurrency safety
└── 🚀 Deployment
    ├── Docker containers
    ├── CI/CD pipeline
    └── Monitoring & logs

Data Sources

• GitHub API - Repository trends and statistics
• Dev.to API - Developer community articles
• RSS Feeds - CSS-Tricks, Hacker News, etc.
• Web Scraping - Additional frontend resources

💻 Development

Prerequisites

• Go 1.21+
• Docker & Docker Compose
• GitHub CLI (for project management)

Build Commands

# Development build
make build-dev

# Production build
make build-prod

# Cross-platform builds
make build-all

# Run tests
make test

# Test coverage
make test-coverage

# Docker build
make docker-build

Testing

The project includes comprehensive testing with >80% coverage:

# Run all tests
make test

# Integration tests
make test-integration

# MCP protocol tests
make test-mcp

# View coverage report
open coverage/coverage.html

🚀 Deployment

Production Deployment

# Build production image
make docker-build

# Deploy with monitoring
docker-compose -f docker-compose.prod.yml up -d

# Check health
curl http://localhost:8080/health

Environment Configuration

Key environment variables:

# Server Configuration
MCP_SERVER_HOST=0.0.0.0
MCP_SERVER_PORT=8080

# Cache Configuration  
REDIS_URL=redis://localhost:6379

# API Keys (store securely)
GITHUB_TOKEN=your_github_token
DEV_TO_API_KEY=your_dev_to_key

See DEPLOYMENT.md for detailed deployment instructions.

📚 API Documentation

• API Reference - Complete MCP tools documentation
• Installation Guide - Step-by-step setup instructions
• Troubleshooting - Common issues and solutions

📋 Project Management

This project was built using the Claude Code PM system for spec-driven development:

Development Workflow

• ✅ PRD Creation - Comprehensive product requirements
• ✅ Epic Planning - Technical architecture and approach
• ✅ Task Decomposition - Granular implementation tasks
• ✅ GitHub Integration - Full issue tracking and traceability
• ✅ Parallel Execution - Multiple concurrent development streams

Project Status

• 🎉 Epic MVP Completed - 100% (8/8 tasks)
• ✅ MCP SDK Integration
• ✅ Multi-source Data Collection
• ✅ Cache Management System
• ✅ Core MCP Tools Implementation
• ✅ Data Processing & Formatting
• ✅ Complete Test Suite (>80% coverage)
• ✅ Production Deployment & Documentation

Project Management Commands

# View project status
/pm:status

# Sync with GitHub Issues
/pm:sync

# View all completed work
/pm:epic-show mvp

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Run tests: make test
5. Commit changes: git commit -m 'Add amazing feature'
6. Push to branch: git push origin feature/amazing-feature
7. Open a Pull Request

📊 Project Metrics

• Lines of Code: 15,000+
• Test Coverage: >80%
• Build Time: <2 minutes
• Docker Image: <50MB (Alpine-based)
• Startup Time: <5 seconds

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🎯 Roadmap

• Additional data sources integration
• Advanced filtering and personalization
• GraphQL API support
• WebSocket real-time updates
• Mobile-optimized responses

---

Built with Claude Code using spec-driven development and GitHub Issues project management.

⭐ Star History

If this project helps you, please consider giving it a star!