MCP Panther

🚀 Panther MCP Server

Panther的模型上下文协议（MCP）服务器具备以下功能：

1. 在IDE中编写和调整检测规则
2. 使用自然语言交互式查询安全日志
3. 对一个或多个警报进行分类、评论和解决

🔍 可用工具

警报工具

数据工具

规则工具

架构工具

指标工具

用户工具

⚠️ 安全最佳实践

Panther强烈建议遵循以下MCP最佳实践：

• 仅运行受信任的、官方签名的MCP服务器：在运行前验证数字签名或校验和，审计工具代码，并避免使用非官方发布者的社区工具。
• 对Panther API令牌应用严格的最小权限原则：将令牌的权限范围设置为所需的最小权限，并将其绑定到IP允许列表或CIDR范围，这样即使令牌被泄露也将毫无用处。定期轮换凭证（例如，每30天一次）。
• 将MCP服务器部署在锁定的沙箱（如Docker）中，并使用只读挂载：这样可以将任何安全漏洞的影响范围降至最低。
• 监控对Panther的凭证访问并监测异常情况：可以编写一个Panther规则来实现！
• 使用mcp - scan扫描MCP服务器：利用invariantlabs提供的mcp - scan工具来检测常见漏洞。

⚙️ Panther配置

1. 在Panther中创建API令牌：

   • 导航到设置（齿轮图标）→ API令牌
   • 创建一个具有以下权限的新令牌（建议从只读权限开始）：
   查看所需权限

   

2. 安全地存储生成的令牌（例如，存储在1Password中）

3. 从浏览器中获取Panther实例URL（例如，https://YOUR - PANTHER - INSTANCE.domain）

   • 注意：URL必须包含https://

📦 安装指南

请选择以下安装方法之一：

Docker安装（推荐）

使用我们预先构建的Docker镜像开始使用是最简单的方法：

{
  "mcpServers": {
    "mcp-panther": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e", "PANTHER_INSTANCE_URL",
        "-e", "PANTHER_API_TOKEN",
        "--rm",
        "ghcr.io/panther-labs/mcp-panther"
      ],
      "env": {
        "PANTHER_INSTANCE_URL": "https://YOUR-PANTHER-INSTANCE.domain",
        "PANTHER_API_TOKEN": "YOUR-API-KEY"
      }
    }
  }
}

UVX安装

对于Python用户，可以使用uvx直接从PyPI运行：

1. 安装UV
2. 配置MCP客户端：

{
  "mcpServers": {
    "mcp-panther": {
      "command": "uvx",
      "args": ["mcp-panther"],
      "env": {
        "PANTHER_INSTANCE_URL": "https://YOUR-PANTHER-INSTANCE.domain",
        "PANTHER_API_TOKEN": "YOUR-PANTHER-API-TOKEN"
      }
    }
  }
}

💻 使用示例

Cursor客户端

按照此处的说明配置项目或全局MCP配置。非常重要的是，不要将此文件提交到版本控制中。

配置完成后，导航到Cursor设置 > MCP以查看正在运行的服务器：

提示：

• 使用@符号指定要生成新规则的具体目录。
• 为了在使用工具时获得更高的可靠性，尝试选择特定的模型，如Claude 3.7 Sonnet。
• 如果MCP客户端无法从Panther MCP服务器找到任何工具，请尝试重启客户端并确保MCP服务器正在运行。在Cursor中，刷新MCP服务器并开始新的聊天。

Claude Desktop客户端

要在Claude Desktop中使用，请手动配置claude_desktop_config.json：

1. 打开Claude Desktop设置并导航到开发者选项卡
2. 点击“编辑配置”以打开配置文件
3. 添加以下配置：

{
  "mcpServers": {
    "mcp-panther": {
      "command": "uvx",
      "args": ["mcp-panther"],
      "env": {
        "PANTHER_INSTANCE_URL": "https://YOUR-PANTHER-INSTANCE.domain",
        "PANTHER_API_TOKEN": "YOUR-PANTHER-API-TOKEN"
      }
    }
  }
}

4. 保存文件并重启Claude Desktop

如果遇到任何问题，请尝试此处的故障排除步骤。

Goose客户端

与Goose（Block的开源AI代理）一起使用：

# 使用MCP服务器启动Goose
goose session --with-extension "uvx mcp-panther"

🛠️ 故障排除

查看服务器日志以获取详细的错误消息：tail -n 20 -F ~/Library/Logs/Claude/mcp*.log。以下是常见问题及解决方案：

• 如果出现{"success": false, "message": "Failed to [action]: Request failed (HTTP 403): {\"error\": \"forbidden\"}"}错误，这可能意味着您的API令牌缺少该工具所需的特定权限。
• 确保您的Panther实例URL设置正确。您可以在MCP客户端的config://panther资源中查看此信息。

📄 许可证

本项目采用Apache License 2.0许可协议 - 详情请参阅LICENSE文件。

👥 贡献者

本项目的成功离不开所有贡献者的努力。特别感谢来自Block的Tomasz Tchorz和Glenn Edwards，他们在与Panther的联合开源项目MCP - Panther的启动过程中发挥了核心作用。

完整的贡献者列表请参阅CONTRIBUTORS.md。

🤝 贡献指南

我们欢迎大家为改进MCP - Panther做出贡献！您可以通过以下方式提供帮助：

• 报告问题：为任何漏洞或功能请求创建一个问题
• 提交拉取请求：分叉仓库并提交修复漏洞或新增功能的PR
• 改进文档：帮助我们使文档更加清晰和全面
• 分享使用案例：告诉我们您如何使用MCP - Panther以及如何使其变得更好

请确保您的贡献遵循我们的编码标准，并包含适当的测试和文档。