EOL MCP Server 📅
A Model Context Protocol (MCP) server that enables AI assistants like Claude to check software end-of-life (EOL) dates and support status using the endoflife.date API. This helps AI models provide accurate information about software lifecycle and security status in real-time.
What is MCP? 🤔
The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop, connect to external tools and data sources. It provides a standardized way for AI assistants to work with local services and APIs while keeping the user in control.
What does this server do? 🚀
The EOL MCP server:
- Checks software end-of-life dates and support status
- Scans for CVE vulnerabilities in software versions
- Provides version comparison and upgrade recommendations
- Supports natural language queries about software lifecycle
- Handles multiple software products (Python, Node.js, Ubuntu, etc.)
- Caches recent queries for quick reference
Features ✨
Core Functionality
- Real-time EOL date validation
- Version support status checking
- Security vulnerability analysis
- Comprehensive version comparison
- Natural language query processing
- Detailed lifecycle validation
Tools
check_version- Get EOL dates and support status
- Check latest patch versions
- Verify LTS status
- Validate support timeline
get_all_details(New!)- Get comprehensive lifecycle details
- View all version cycles
- Check support timeline
- Get validation results
- Calculate remaining support days
compare_versions- Compare current vs latest versions
- Get upgrade recommendations
- Check compatibility
- Assess upgrade urgency
- Validate upgrade paths
check_cve- Security vulnerability scanning
- Support status verification
- Security patch validation
- Vendor support checking
list_products- Browse available software
- Search with filters
- Verify product names
- Get product details
Prompts
check_software_status- Validate version support
- Check EOL dates
- Get security status
compare_versions- Analyze version differences
- Get upgrade recommendations
- Check compatibility
analyze_security- Security vulnerability analysis
- Support status check
- Patch verification
natural_language_query- Process natural language questions
- Get contextual responses
- Smart version detection
validate_version- Validate version recommendations
- Check support status
- Verify security implications
Response Examples
Version Validation
{
"current_date": "2024-02-20T00:00:00.000Z",
"validations": {
"current": {
"version": "1.20",
"eol_check": {
"date": "2024-02-06",
"valid": false,
"days_remaining": -14,
"message": "Version 1.20 EOL date 2024-02-06 is invalid, -14 days from now"
},
"support": {
"status": "not supported",
"lts": "not LTS"
}
}
},
"recommendation": {
"needs_update": true,
"urgency": "critical",
"message": "Current version needs urgent upgrade - use a supported version"
}
}
All Details Response (New!)
{
"product": "go",
"current_date": "2024-02-20T00:00:00.000Z",
"cycles": [
{
"cycle": "1.22",
"releaseDate": "2024-02-06",
"eol": "2025-02-06",
"latest": "1.22.0",
"validation": {
"is_valid": true,
"days_to_eol": 351,
"is_supported": true,
"message": "Version 1.22 EOL date 2025-02-06 is valid, +351 days from now"
}
}
]
}
Example Conversations 💬
- Basic Version Check:
Human: Is Python 3.8 still good to use?
Claude: Let me check the status of Python 3.8.
[Uses check_version tool]
Based on the EOL data, Python 3.8:
- Security support ends: October 2024
- Current status: Security fixes only
Recommendation: Consider upgrading to Python 3.11 for new projects.
- Security Analysis:
Human: Any security concerns with Node.js 16?
Claude: I'll analyze the security status of Node.js 16.
[Uses check_version tool]
[Uses check_cve tool]
Found:
- Support Status: LTS until September 2023
- Critical CVEs: 2 in last 6 months
- CVSS Score Range: 7.5-9.8
Recommendation: Update to latest 16.x patch or consider Node.js 18 LTS.
- Version Comparison:
Human: Which Ubuntu version should I use?
Claude: I'll help you compare Ubuntu versions.
[Uses version-comparison prompt]
Analysis:
- 22.04 LTS: Supported until 2027, recommended for new deployments
- 20.04 LTS: Supported until 2025, stable and widely used
- 18.04 LTS: Approaching EOL, plan migration
Recommendation: Use 22.04 LTS for best long-term support.
Prerequisites 📋
Before you begin, ensure you have:
- Node.js (v18 or higher)
- Claude Desktop installed
- Git installed
You can verify your Node.js installation by running:
node --version # Should show v18.0.0 or higher
Installation 🛠️
- Clone the repository:
git clone https://github.com/ducthinh993/mcp-server-endoflife
cd mcp-server-endoflife
- Install dependencies:
npm install
- Build the project:
npm run build
- Create a global link:
npm link
Configuration ⚙️
1. Claude Desktop Configuration
Configure Claude Desktop to recognize the EOL MCP server:
For macOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
For Windows:
code %APPDATA%\Claude\claude_desktop_config.json
Add the EOL server configuration:
{
"mcpServers": {
"eol": {
"command": "npx",
"args": ["/path/to/eol-mcp-server/build/index.js"]
}
}
}
2. Restart Claude Desktop
For the changes to take effect:
- Completely quit Claude Desktop (not just close the window)
- Start Claude Desktop again
- Look for the 🔌 icon to verify the EOL server is connected
Troubleshooting 🔧
Common Issues
Server Not Found
- Verify the npm link is correctly set up
- Check Claude Desktop configuration syntax
- Ensure Node.js is properly installed
API Issues
- Check if endoflife.date API is accessible
- Verify the API response format hasn't changed
- Check network connectivity
Connection Issues
- Restart Claude Desktop completely
- Check Claude Desktop logs:
# macOS tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
Getting Help
If you encounter issues:
- Review the MCP Documentation
- Check the endoflife.date API Documentation
- Open an issue in the GitHub repository
Acknowledgments 🙏
- endoflife.date for their comprehensive software lifecycle API
- Model Context Protocol for the MCP specification
- Anthropic for Claude Desktop
