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:
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:
Acknowledgments 🙏
