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以及如何使其變得更好

請確保您的貢獻遵循我們的編碼標準，幷包含適當的測試和文檔。