Интегрирует платформу сканирования безопасности StackHawk в IDE на базе LLM для автоматизации настройки проектов, запуска сканирований безопасности и сортировки уязвимостей.
Также известен как stackhawk/stackhawk-mcp, stackhawk-mcp
- Звёзды
- 9
- Инструменты
- —
- Загрузки, 30 дней
- 205
- Последняя версия
- 1.1.1
- Последний коммит
- 9 окт. 2026 г.
- Лицензия
- —
Что такое StackHawk MCP?
StackHawk — это MCP server. Интегрирует платформу сканирования безопасности StackHawk в IDE на базе LLM для автоматизации настройки проектов, запуска сканирований безопасности и сортировки уязвимостей.
Сводка сгенерирована из README проекта
О StackHawk MCP server
Этот MCP server позволяет разработчикам автоматизировать сканирование безопасности и сортировку уязвимостей прямо из IDE с поддержкой ИИ. Благодаря подключению к платформе сканирования безопасности StackHawk, пользователи могут управлять всем жизненным циклом безопасности через чат или интерфейс командной строки. Сервер работает локально через Python-сервер или как удаленный HTTP-сервис, требуя переменную окружения STACKHAWK_API_KEY для аутентификации запросов.
Разработчики могут использовать специальные инструменты для определения языков проектов, создания приложений и генерации конфигурационного файла stackhawk.yml. Сервер включает специализированные инструменты валидации, такие как validate_stackhawk_config и validate_field_exists, чтобы гарантировать соответствие YAML-файлов официальной схеме и предотвратить галлюцинации ИИ. После настройки пользователи могут запускать сканирования с помощью run_stackhawk_scan и получать готовые к обработке результаты через get_app_findings_for_triage. Эта интеграция совместима с такими средами, как Cursor, Windsurf и GitHub Copilot Agents.
Что вы можете с ним делать
- 1Автоматизированная настройка безопасности проектаНастройте новый проект для сканирования безопасности, автоматически определяя язык программирования и генерируя необходимые конфигурационные файлы.
- 2Прямая сортировка уязвимостейВыявляйте и анализируйте результаты сканирования безопасности, которые соответствуют вашим пороговым значениям критичности, чтобы приступить к их устранению.
- 3Запуск сканирований безопасности через чатЗапускайте полное сканирование безопасности вашего приложения напрямую через вашего ИИ-ассистента для написания кода.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить StackHawk MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка StackHawk MCP в Claude Code
$ claude mcp add --env 'STACKHAWK_API_KEY=<YOUR_STACKHAWK_API_KEY>' stackhawk-mcp -- uvx stackhawk-mcpУстановка StackHawk MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"stackhawk-mcp": {
"command": "uvx",
"args": [
"stackhawk-mcp"
],
"env": {
"STACKHAWK_API_KEY": "<YOUR_STACKHAWK_API_KEY>"
}
}
}
}Установка StackHawk MCP в VS Code
.vscode/mcp.json
{
"servers": {
"stackhawk-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"stackhawk-mcp"
],
"env": {
"STACKHAWK_API_KEY": "<YOUR_STACKHAWK_API_KEY>"
}
}
}
}Установка StackHawk MCP в VS Code CLI
$ code --add-mcp '{"name":"stackhawk-mcp","type":"stdio","command":"uvx","args":["stackhawk-mcp"],"env":{"STACKHAWK_API_KEY":"<YOUR_STACKHAWK_API_KEY>"}}'Установка StackHawk MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"stackhawk-mcp": {
"command": "uvx",
"args": [
"stackhawk-mcp"
],
"env": {
"STACKHAWK_API_KEY": "<YOUR_STACKHAWK_API_KEY>"
}
}
}
}Установка StackHawk MCP в Codex
$ codex mcp add stackhawk-mcp --env 'STACKHAWK_API_KEY=<YOUR_STACKHAWK_API_KEY>' -- uvx stackhawk-mcpУстановка StackHawk MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.stackhawk-mcp] command = "uvx" args = ["stackhawk-mcp"] [mcp_servers.stackhawk-mcp.env] STACKHAWK_API_KEY = "<YOUR_STACKHAWK_API_KEY>"
Установка StackHawk MCP в Gemini CLI
$ gemini mcp add -s user -e 'STACKHAWK_API_KEY=<YOUR_STACKHAWK_API_KEY>' stackhawk-mcp uvx -- stackhawk-mcpУстановка StackHawk MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"stackhawk-mcp": {
"command": "uvx",
"args": [
"stackhawk-mcp"
],
"env": {
"STACKHAWK_API_KEY": "<YOUR_STACKHAWK_API_KEY>"
}
}
}
}Конфигурация
STACKHAWK_API_KEYОбязательноСекретStackHawk API key
| Название | Описание | Тип |
|---|---|---|
| STACKHAWK_API_KEY | StackHawk API key | ОбязательноСекрет |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийstackhawk/stackhawk-mcp is public and reachablegithub.com/stackhawk/stackhawk-mcp ↗Пройдено
- Пакет указывает этот репозиторий как источникstackhawk-mcp names stackhawk/stackhawk-mcp as sourcepypi.org/project/stackhawk-mcp/ ↗Пройдено
- Происхождение сборки (аттестация Sigstore)Sigstore attestation for stackhawk-mcppypi.org/project/stackhawk-mcp/ ↗Пройдено
- Open source лицензия (OSI)No licenseПроблема
- Коммит или релиз за последний годLast commit or release 2026-10-09github.com/stackhawk/stackhawk-mcp ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from stackhawk-mcpПройдено
- Нет критических предупреждений в пакете или его зависимостях34 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubStackHawk MCP Server
Current Version: 1.2.5 Requires Python 3.10 or higher
A Model Context Protocol (MCP) server for integrating with StackHawk's security scanning platform. Helps developers set up StackHawk, run security scans, and triage findings to fix vulnerabilities — all from within an LLM-powered IDE or chat.
Table of Contents
- Features
- Installation
- Usage
- Configuration
- Available Tools
- Testing & Development
- Example Configurations
- Integrating with LLMs and IDEs
- Contributing
- License
Features
- Setup: Detect your project, create a StackHawk application, and generate a ready-to-scan
stackhawk.yml - Scan: Run StackHawk scans directly from your IDE or chat (with install help if the CLI is missing)
- Triage: Get actionable findings at or above your failure threshold for remediation
- Validate: Check YAML configs against the official schema and validate field paths to prevent hallucination
- Custom User-Agent: All API calls include a versioned
User-Agentheader
Installation
- Install via pip (make sure you have write permission to your current python environment):
> pip install stackhawk-mcp # Requires Python 3.10 or higher
Or Install via pip in a virtual env:
> python3 -m venv ~/.virtualenvs/mcp
> source ~/.virtualenvs/mcp/bin/activate
> (mcp) pip install stackhawk-mcp
# Requires Python 3.10 or higher
Or Install via pip using pyenv:
> pyenv shell 3.10.11
> pip install stackhawk-mcp
# Requires Python 3.10 or higher
Or Install locally from this repo:
> pip install --user .
# Run this command from the root of the cloned repository
- Set your StackHawk API key:
> export STACKHAWK_API_KEY="your-api-key-here"
Usage
Running the MCP Server
python -m stackhawk_mcp.server
Running the HTTP Server (FastAPI)
python -m stackhawk_mcp.http_server
Running Tests
pytest
Integrating with LLMs and IDEs
StackHawk MCP can be used as a tool provider for AI coding assistants and LLM-powered developer environments, enabling security scanning setup, YAML validation, and vulnerability triage directly in your workflow.
Cursor (AI Coding Editor)
- Setup:
- Follow the installation instructions above to install
stackhawk-mcpin your python environment. - In Cursor, go to
Cursor Settings->Tools & Integrations->MCP Tools - Add a "New MCP Server" with the following json, depending on your setup:
- Using a virtual env at
~/.virtualenvs/mcp:{ "mcpServers": { "stackhawk": { "command": "/home/bobby/.virtualenvs/mcp/bin/python", "args": ["-m", "stackhawk_mcp.server"], "env": { "STACKHAWK_API_KEY": "${env:STACKHAWK_API_KEY}" }, "disabled": false } } } - Using pyenv:
{ "mcpServers": { "stackhawk": { "command": "/home/bobby/.pyenv/versions/3.10.11/bin/python3", "args": ["-m", "stackhawk_mcp.server"], "env": { "STACKHAWK_API_KEY": "${env:STACKHAWK_API_KEY}" }, "disabled": false } } } - Or use python directly:
{ "mcpServers": { "stackhawk": { "command": "python3", "args": ["-m", "stackhawk_mcp.server"], "env": { "STACKHAWK_API_KEY": "${env:STACKHAWK_API_KEY}" } } } } - Then make sure the "stackhawk" MCP Tool is enabled
- Using a virtual env at
- Follow the installation instructions above to install
- Usage:
- Use Cursor's tool invocation to call StackHawk MCP tools (e.g., vulnerability search, YAML validation).
- Example prompt:
Validate this StackHawk YAML config for errors.
OpenAI, Anthropic, and Other LLMs
- Setup:
- Deploy the MCP HTTP server and expose it to your LLM system (local or cloud).
- Use the LLM's tool-calling or function-calling API to connect to the MCP endpoint.
- Pass the required arguments (e.g., org_id, yaml_content) as specified in the tool schemas.
- Example API Call:
{ "method": "tools/call", "params": { "name": "validate_stackhawk_config", "arguments": {"yaml_content": "..."} } } - Best Practices:
- Use anti-hallucination tools to validate field names and schema compliance.
- Always check the tool's output for warnings or suggestions.
IDEs like Windsurf
- Setup:
- Add StackHawk MCP as a tool provider or extension in your IDE, pointing to the local or remote MCP server endpoint.
- Configure environment variables as needed.
- Usage:
- Invoke setup, scanning, validation, and triage tools directly from the IDE's command palette or tool integration panel.
General Tips
- Ensure the MCP server is running and accessible from your LLM or IDE environment.
- Review the Available Tools & API section for supported operations.
- For advanced integration, see the example tool usage in this README or explore the codebase for custom workflows.
GitHub Copilot Agents
StackHawk can be added to the GitHub Coding Agent as an MCP server or as its own GitHub Custom Agent.
Add to GitHub Coding Agent
You can add StackHawk MCP to the GitHub Copilot Coding Agent. This gives the agent all the stackhawk/ tools.
StackHawk MCP installation into the Coding Agent
General instructions on GitHub
For StackHawk MCP, the MCP Configuration JSON should look something like this:
{
"mcpServers": {
"stackhawk": {
"type": "local",
"tools": [
"*"
],
"command": "uvx",
"args": [
"stackhawk-mcp"
],
"env": {
"STACKHAWK_API_KEY": "COPILOT_MCP_STACKHAWK_API_KEY"
}
}
}
}
Then in the Repository's Settings->Environments->copilot->Environment Secrets, add COPILOT_MCP_STACKHAWK_API_KEY with your StackHawk API Key.
Installation verification instructions
StackHawk Onboarding Agent as a GitHub Copilot Custom Agent
You can the StackHawk Onboarding Agent as a custom agent at the enterprise, organization, or repository level in GitHub. When added, the StackHawk Onboarding Agent becomes a selectable option in the Copilot Agent Chat with context to help with onboarding, plus it installs stackhawk-mcp so the agent has access to all of those tools.
StackHawk Onboarding Agent installation
The general approach is to take the StackHawk Onboarding Agent defintion and apply it to either the desired repository, enterprise, or organization in GitHub.
- Instructions for installing into a repository on GitHub
- Instructions for installing into an enterprise on GitHub
- Instructions for installing into an organization GitHub
Note that the mcp-servers block in the StackHawk Onboarding Agent definition references an environment variable called COPILOT_MCP_STACKHAWK_API_KEY. Go to the Repository's Settings->Environments->copilot->Environment Secrets, add COPILOT_MCP_STACKHAWK_API_KEY with your StackHawk API Key.
Configuration
- All HTTP requests include a custom
User-Agentheader:User-Agent: StackHawk-MCP/{version} - The version is set in
stackhawk_mcp/server.pyasSTACKHAWK_MCP_VERSION. - Set your API key via the
STACKHAWK_API_KEYenvironment variable.
Available Tools
The MCP server exposes 7 tools organized around the developer workflow:
| Phase | Tool | Description |
|---|---|---|
| Discover | get_organization_info |
Get org details, teams, and applications |
| Discover | list_applications |
List applications in an organization |
| Setup | setup_stackhawk_for_project |
Detect language, find/create app, generate stackhawk.yml |
| Validate | validate_stackhawk_config |
Validate YAML against the official StackHawk schema |
| Validate | validate_field_exists |
Check if a field path is valid in the schema (anti-hallucination) |
| Scan | run_stackhawk_scan |
Run a StackHawk scan via the CLI (returns install help if CLI is missing) |
| Triage | get_app_findings_for_triage |
Get findings at/above the configured failure threshold |
Example Tool Usage
# Set up StackHawk for a project
result = await server.call_tool("setup_stackhawk_for_project", {"host": "http://localhost:3000"})
# Validate a YAML config
result = await server.call_tool("validate_stackhawk_config", {"yaml_content": "..."})
# Run a scan
result = await server.call_tool("run_stackhawk_scan", {})
# Get findings to triage
result = await server.call_tool("get_app_findings_for_triage", {})
Official Schema URL: https://download.stackhawk.com/hawk/jsonschema/hawkconfig.json
Testing & Development
Running All Tests
pytest
Running Individual Tests
pytest tests/test_ux_improvements.py
pytest tests/test_user_scenarios.py
Code Formatting
black stackhawk_mcp/
Type Checking
mypy stackhawk_mcp/
Example Configurations
Basic Configuration
app:
applicationId: "12345678-1234-1234-1234-123456789012"
env: "dev"
host: "http://localhost:3000"
name: "Development App"
description: "Local development environment"
Production Configuration with Authentication
app:
applicationId: "87654321-4321-4321-4321-210987654321"
env: "prod"
host: "https://myapp.com"
name: "Production App"
description: "Production environment"
authentication:
type: "form"
username: "your-username"
password: "your-password"
loginUrl: "https://myapp.com/login"
usernameField: "username"
passwordField: "password"
hawk:
spider:
base: true
ajax: false
maxDurationMinutes: 30
scan:
maxDurationMinutes: 60
threads: 10
startupTimeoutMinutes: 5
failureThreshold: "high"
tags:
- name: "environment"
value: "production"
- name: "application"
value: "myapp"
Contributing
Contributions are welcome! Please open issues or pull requests for bug fixes, new features, or documentation improvements.
License
Apache License 2.0. See LICENSE for details.
Release and Version Bumping
Version bumps are managed via the "Prepare Release" GitHub Actions workflow. When triggering this workflow, you can select whether to bump the minor or major version. The workflow will automatically update version files, commit, and push the changes to main.
Note: The workflow is protected against infinite loops caused by automated version bump commits.
GitHub Actions Authentication
All CI/CD git operations use a GitHub App token for authentication.
The git user and email are set from the repository secrets HAWKY_APP_USER and HAWKY_APP_USER_EMAIL.
Workflow Protections
Workflows are designed to skip jobs if the latest commit is an automated version bump, preventing workflow loops.
How to Trigger a Release
- Go to the "Actions" tab on GitHub.
- Select the "Prepare Release" workflow.
- Click "Run workflow" and choose the desired bump type (minor or major).
- The workflow will handle the rest!
Вопросы о StackHawk MCP
Как добавить StackHawk MCP в Claude Code?
Выполните claude mcp add --env 'STACKHAWK_API_KEY=<YOUR_STACKHAWK_API_KEY>' stackhawk-mcp -- uvx stackhawk-mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить StackHawk MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Что я могу делать с помощью StackHawk MCP server?
Вы можете обнаруживать проекты, создавать приложения StackHawk, генерировать конфигурационные файлы, запускать сканирования безопасности и проводить сортировку найденных проблем для их устранения.
Как установить StackHawk MCP server?
Вы можете установить его через pip с помощью команды pip install stackhawk-mcp.
Какие системные требования для этого сервера?
Для работы сервера требуется Python 3.10 или выше.