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

1. check_version

• Get EOL dates and support status
• Check latest patch versions
• Verify LTS status
• Validate support timeline

2. get_all_details (New!)

• Get comprehensive lifecycle details
• View all version cycles
• Check support timeline
• Get validation results
• Calculate remaining support days

3. compare_versions

• Compare current vs latest versions
• Get upgrade recommendations
• Check compatibility
• Assess upgrade urgency
• Validate upgrade paths

4. check_cve

• Security vulnerability scanning
• Support status verification
• Security patch validation
• Vendor support checking

5. list_products

• Browse available software
• Search with filters
• Verify product names
• Get product details

Prompts

1. check_software_status

• Validate version support
• Check EOL dates
• Get security status

2. compare_versions

• Analyze version differences
• Get upgrade recommendations
• Check compatibility

3. analyze_security

• Security vulnerability analysis
• Support status check
• Patch verification

4. natural_language_query

• Process natural language questions
• Get contextual responses
• Smart version detection

5. 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 💬

1. 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.

2. 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.

3. 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 🛠️

1. Clone the repository:

git clone https://github.com/ducthinh993/mcp-server-endoflife
cd mcp-server-endoflife

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. 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:

1. Completely quit Claude Desktop (not just close the window)

2. Start Claude Desktop again

3. Look for the 🔌 icon to verify the EOL server is connected

Troubleshooting 🔧

Common Issues

1. Server Not Found

• Verify the npm link is correctly set up
• Check Claude Desktop configuration syntax
• Ensure Node.js is properly installed

2. API Issues

• Check if endoflife.date API is accessible
• Verify the API response format hasn't changed
• Check network connectivity

3. 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