使用说明

项目简介

'santa-mcp' 是一个概念验证 (PoC) 的 MCP (Model Context Protocol) 服务器，专门为 macOS 上的开源安全工具 Santa 设计。它使得支持 MCP 协议的大型语言模型 (LLM) 能够与 Santa 进行交互和控制。

请注意： 这是一个 PoC 项目，仅用于演示目的，不适合生产环境。

主要功能点

工具执行: 将 'santactl' 命令行工具的多个子命令封装成 MCP 工具，允许 LLM 执行 Santa 的功能，例如：
- 查询 Santa 版本 ('santactl version')
- 获取 Santa 状态信息 ('santactl status')
- 同步 Santa 规则 ('santactl sync')
- 获取文件信息 ('santactl fileinfo')
- 获取性能指标 ('santactl metrics')
Prompt 支持: 提供 Prompt 模板，辅助 LLM 理解和使用工具，例如解释 'santactl status' 的输出，或列出 'santactl' 的可用子命令。
Stdio 传输: 使用标准输入/输出 (stdio) 作为 MCP 服务器与客户端之间的通信通道。

安装步骤

安装 Claude Desktop (如果需要): 如果您还没有安装 Claude Desktop，请从 https://claude.ai/download 下载并安装。
构建服务器: 打开终端，进入 'santa-mcp' 仓库目录，运行 'make' 命令编译 'santa-mcp' 二进制文件。
复制二进制文件: 将编译生成的 'santa-mcp' 二进制文件复制到您系统中的某个目录，例如 '/usr/local/bin/'。
编辑配置文件: 修改仓库中提供的 'claude_desktop_config.json' 文件。将 '"command"' 字段的值更新为您在步骤 3 中复制的 'santa-mcp' 二进制文件的路径 (例如 '"/usr/local/bin/santa-mcp"' )。
复制配置文件: 将修改后的 'claude_desktop_config.json' 文件复制到 Claude Desktop 的应用支持目录：'~/Library/Application Support/Claude/'。
打开 Claude Desktop: 启动或重启 Claude Desktop。您应该能在 Claude 中看到注册的 Santa 工具。

服务器配置 (MCP 客户端配置 - 以 Claude Desktop 为例)

MCP客户端需要配置 MCP服务器的启动命令才能连接。以下是 Claude Desktop 的 'claude_desktop_config.json' 示例配置，用于连接 'santa-mcp' 服务器：

{
  "servers": [
    {
      "name": "santa-mcp",
      "command": "/path/to/santa-mcp",  // 请替换为 santa-mcp 二进制文件的实际路径，例如 "/usr/local/bin/santa-mcp"
      "args": []                      // 此处不需要命令行参数
    }
  ]
}

注意: 请将 '/path/to/santa-mcp' 替换为您在安装步骤 3 中放置 'santa-mcp' 二进制文件的实际路径。此配置告知 Claude Desktop 如何启动和连接 'santa-mcp' 服务器。

基本使用方法

完成配置并启动 Claude Desktop 后，您可以通过 Claude 与 Santa 进行交互，例如询问有关 macOS 安全和 Santa 功能的问题或发出指令。

例如，您可以向 Claude 提问：

"Santa 版本是什么？"
"Santa 当前状态如何？"
"为什么 Santa 阻止了 osascript？"
"获取 /Applications/Safari.app 的文件信息"

Claude Desktop 将利用 'santa-mcp' 服务器提供的工具和 Prompt 来解答您的问题，并与您 macOS 系统上的 Santa 安全工具进行交互。

关键词