Metadata-Version: 2.4
Name: ssl-expiry-checker-mcp
Version: 0.1.0
Summary: MCP server for checking SSL certificate expiration dates
Project-URL: Homepage, https://github.com/tojoevan/ssl-expiry-checker-mcp
Project-URL: Repository, https://github.com/tojoevan/ssl-expiry-checker-mcp
Project-URL: Issues, https://github.com/tojoevan/ssl-expiry-checker-mcp/issues
Author-email: Joevan <tojoevan@gmail.com>
License: MIT
License-File: LICENSE
Keywords: certificate,mcp,monitoring,security,ssl
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.11
Requires-Dist: build>=1.4.0
Requires-Dist: mcp[cli]>=1.26.0
Requires-Dist: twine>=6.2.0
Description-Content-Type: text/markdown

# SSL 证书到期检查器 MCP 服务器

一个基于 MCP (Model Context Protocol) 的 SSL 证书到期检查工具，可以快速检查任何网站的 SSL 证书有效期。

## 功能特性

- 🔍 检查任意域名的 SSL 证书到期时间
- ⏰ 计算证书剩余有效天数
- 🚨 智能状态提示（已过期/即将过期/有效）
- 🌐 支持多种 URL 格式输入

## 安装

确保已安装 Python 3.11 或更高版本，然后使用 uv 安装依赖：

```bash
uv sync
```

## 使用方法

### 作为 MCP 服务器运行

```bash
uv run main.py
```

### 在 Claude Desktop 中配置

编辑 Claude Desktop 配置文件：

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

添加以下配置：

```json
{
  "mcpServers": {
    "ssl-checker": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ssl-expiry-checker-mcp",
        "run",
        "main.py"
      ]
    }
  }
}
```

## 工具说明

### ssl_expiry_checker

检查给定网址的 SSL 证书有效期。

**参数**:
- `url` (string): 要检查的网址，支持以下格式：
  - `example.com`
  - `https://example.com`
  - `www.example.com`

**返回**: 包含证书到期信息的详细报告

## 示例输出

```
**SSL 证书检查结果**
目标网址: https://example.com
域名: example.com
到期时间: 2026-12-31 23:59:59 UTC
剩余天数: 305 天
状态: ✅ 证书有效
```

### 状态说明

- ✅ **证书有效**: 剩余天数 ≥ 7 天
- ⚠️ **证书即将过期**: 剩余天数 < 7 天
- ⏳ **证书将在今天过期**: 剩余天数 = 0 天
- 🚨 **证书已过期**: 剩余天数 < 0 天

## 技术栈

- Python 3.11+
- FastMCP
- 标准库: ssl, socket, urllib

## 许可证

MIT
