SSLMate MCP Server

2025-07-02 | Joshua Wright | 使用GitHub Copilot和Claude Sonnet 4编写

这是一个使用CertSpotter API提供SSL/TLS证书搜索功能的模型上下文协议（MCP）服务器。通过搜索证书透明度日志来发现任何域的证书，包括全面的子域发现。

此工具的功能

此MCP服务器与Claude Desktop集成，提供了强大的证书发现能力：

• 证书搜索：根据域名在证书透明度日志中查找SSL/TLS证书
• 子域发现：搜索给定域的所有子域所颁发的证书（例如，查找所有*.example.com证书）
• 详细信息：获取全面的证书详情，包括DNS名称、颁发者、有效期等
• 过期证书过滤：选择是否包含或排除结果中的过期证书
• 实时数据：通过CertSpotter API访问实时证书透明度日志数据

要求

• Python 3.8或更高版本
• uv包管理器（安装uv）
• SSLMate API密钥（可选 - 在SSLMate有免费层级）
• MCP客户端（已测试与Claude Desktop兼容）

MCP工具

此服务器为Claude Desktop提供了以下工具：

search_certificates

在证书透明度日志中搜索SSL/TLS证书。

参数：

• domain（字符串，必需）：要搜索的域名（例如，“example.com”）
• include_subdomains（布尔值，可选，默认：false）：如果为true，则搜索所有子域的证书
• include_expired（布尔值，可选，默认：false）：如果为true，则在结果中包含过期证书
• limit（整数，可选，默认：100）：返回的最大结果数量（1-1000）

Claude Desktop集成

1. 配置Claude Desktop

将此服务器添加到您的Claude Desktop配置文件中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sslmate": {
      "command": "uv",
      "args": ["run", "/path/to/sslmate-mcp/sslmate_mcp.py"],
      "env": {
        "SSLMATE_API_KEY": "your-api-key-here"
      }
    }
  }
}

2. 重启Claude Desktop

关闭并重新打开Claude Desktop以加载新服务器。

3. 验证集成

现在，在Claude Desktop中，您应该能够提问如下问题：

• “搜索example.com的证书”
• “查找github.com的所有子域证书”
• “显示my-domain.com的过期证书”

故障排除和日志记录

常见问题

服务器未出现在Claude Desktop中：

1. 检查claude_desktop_config.json中的文件路径
2. 确保已安装并可以访问uv
3. 手动验证服务器是否启动：uv run sslmate_mcp.py

API速率限制：

• 添加您的SSLMate API密钥以增加速率限制
• 免费层级允许大多数需求的合理使用

没有返回结果：

• 尝试包含子域：include_subdomains=true
• 尝试包含过期证书：include_expired=true
• 验证域名是否正确

日志记录

服务器默认将日志记录到stderr以符合MCP协议。启用文件日志记录：

export LOG_TO_FILE=1
uv run sslmate_mcp.py

这将在当前目录创建一个sslmate-mcp.log文件。

测试服务器

直接测试MCP协议：

# 测试基本功能
python test_mcp_protocol.py

# 手动协议测试
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | uv run sslmate_mcp.py

许可证

MIT。详情参见LICENSE文件。

SSLMate API

本项目使用SSLMate API。您需要从SSLMate获取API密钥才能使用此服务器。

有关SSLMate API的更多信息，请访问：https://sslmate.com/api/