项目简介

myssl-mcp-server 是一个实现了 Model Context Protocol (MCP) 的服务器,专注于提供域名和IP安全检测能力。它集成了 MySSL API,允许用户通过 AI 客户端调用工具来查询域名或IP的安全信息,以及检查 MySSL 服务的健康状态。

主要功能点

  • 域名/IP安全检测: 提供 'domain_check' 工具,可以查询域名或IP的详细安全信息,帮助用户确保 HTTPS 部署的安全性。
  • MySSL服务健康检查: 提供 'health_check' 工具,用于验证底层的 MySSL 服务是否正常运行。
  • MCP协议标准: 遵循 MCP 协议,可以与任何兼容 MCP 协议的 AI 客户端无缝集成。

安装步骤

  1. 下载: 访问 Releases page 下载适用于您操作系统的预编译版本。
  2. 解压: 将下载的压缩包解压到您希望安装的目录。
  3. 配置环境变量: 设置 MySSL API 的 AccessKey 和 SecretKey 作为环境变量。您需要在操作系统环境中设置以下两个环境变量:
    {
      "AccessKey": "您的AccessKey",
      "SecretKey": "您的SecretKey"
    }
    请将 '"您的AccessKey"' 和 '"您的SecretKey"' 替换为您实际的 MySSL API 密钥。

服务器配置

要将 myssl-mcp-server 注册到您的 MCP 客户端,您需要提供以下配置信息。这些信息通常在 AI 客户端的插件或扩展管理界面中设置。

{
  "server name": "myssl-mcp-server",  // MCP 服务器的名称,您可以自定义
  "version": "1.0.0",                 // MCP 服务器的版本,与项目版本一致
  "command": "path/to/myssl-mcp-server", // 指向 myssl-mcp-server 可执行文件的路径,请替换为实际路径
  "args": []                           // 启动服务器的命令行参数,本服务器无需参数
}

配置信息说明:

  • 'server name': 服务器的名称,用于在 MCP 客户端中标识和管理该服务器。
  • 'version': 服务器的版本号,与 'main.go' 中定义的版本一致。
  • 'command': 重要!这是 MCP 客户端启动 MCP 服务器时执行的命令。您需要将 'path/to/myssl-mcp-server' 替换为 'myssl-mcp-server' 可执行文件的绝对路径。例如,如果您的可执行文件在 '/home/user/myssl-mcp-server',则 'command' 应设置为 '/home/user/myssl-mcp-server'。
  • 'args': 启动服务器时需要传递的命令行参数。对于 'myssl-mcp-server',它不需要任何额外的命令行参数,因此 'args' 应该是一个空数组 '[]'。

基本使用方法

成功注册并启动 myssl-mcp-server 后,您可以在 AI 客户端中使用以下工具:

  1. domain_check 工具: 用于查询域名或IP的安全信息。

    • 在 AI 客户端的 Prompt 中,您可以指示 AI 调用 'domain_check' 工具并提供域名或 IP 参数。
    • 例如,您可以提问类似于 "请使用 domain_check 工具查询域名 example.com 的安全信息" 或 "使用 domain_check 工具检查 IP 地址 1.2.3.4"。
    • 工具会返回 JSON 格式的安全分析报告。
  2. health_check 工具: 用于检查 MySSL 服务的运行状态。

    • 在 AI 客户端的 Prompt 中,您可以指示 AI 调用 'health_check' 工具。
    • 例如,您可以提问 "MySSL 服务是否正常运行?" 或 "请检查 MySSL 服务的健康状态"。
    • 工具会返回 MySSL 服务的健康状态信息。

使用示例:

您可以在 AI 客户端的 Prompt 中使用自然语言指示 AI 调用相应的工具。例如:

  • "检查域名 google.com 的安全信息" (AI 客户端可能会解析为调用 'domain_check' 工具,参数为 'domain=google.com')
  • "MySSL 服务工作正常吗?" (AI 客户端可能会解析为调用 'health_check' 工具)

请参考仓库 README.md 中的示例图片,了解如何在 AI 客户端中使用这些工具。

信息

分类

网页与API