StackHawkのセキュリティスキャンプラットフォームをLLM搭載IDEに統合し、プロジェクトのセットアップ、セキュリティスキャンの実行、および脆弱性のトリアージを自動化します。
別名 stackhawk/stackhawk-mcp, stackhawk-mcp
- スター
- 9
- ツール
- —
- ダウンロード数(30日間)
- 205
- 最新バージョン
- 1.1.1
- 最終コミット
- 2026年10月9日
- ライセンス
- —
StackHawk MCPとは
StackHawkはMCPサーバーです。 StackHawkのセキュリティスキャンプラットフォームをLLM搭載IDEに統合し、プロジェクトのセットアップ、セキュリティスキャンの実行、および脆弱性のトリアージを自動化します。.
プロジェクトのREADMEから生成された概要
StackHawk MCP server について
このMCP serverは、AI搭載IDE内からセキュリティスキャンと脆弱性のトリアージを自動化することを開発者に提供します。StackHawkセキュリティスキャンプラットフォームに接続することで、チャットやコマンドインターフェースを通じてセキュリティライフサイクル全体を管理できます。Pythonベースのサーバーによるローカル実行、またはリモートHTTPサービスとして動作し、リクエストの認証にはSTACKHAWK_API_KEY環境変数が必要です。
開発者は特定のツールを使用して、プロジェクト言語の検出、アプリケーションの作成、およびstackhawk.yml設定ファイルの生成を行うことができます。このサーバーには、validate_stackhawk_configやvalidate_field_existsといった専用のバリデーションツールが含まれており、YAMLファイルが公式スキーマに準拠していることを確認し、AIのハルシネーションを防ぎます。設定完了後、ユーザーはrun_stackhawk_scanを使用してスキャンを開始し、get_app_findings_for_triageを通じて実用的な検出結果を取得できます。この統合は、Cursor、Windsurf、GitHub Copilot Agentsなどの環境と互換性があります。
できること
- 1プロジェクトのセキュリティセットアップ自動化言語を自動検出し、必要な設定ファイルを生成することで、新しいプロジェクトのセキュリティスキャン設定を行います。
- 2直接的な脆弱性トリアージ設定した失敗しきい値に該当するセキュリティ検出結果を特定・確認し、修正作業を開始します。
- 3チャット経由でのセキュリティスキャン実行AIコーディングアシスタントから直接、アプリケーションのフルセキュリティスキャンを開始します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
StackHawk MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにStackHawk MCPをインストール
$ claude mcp add --env 'STACKHAWK_API_KEY=<YOUR_STACKHAWK_API_KEY>' stackhawk-mcp -- uvx stackhawk-mcpCursorにStackHawk MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"stackhawk-mcp": {
"command": "uvx",
"args": [
"stackhawk-mcp"
],
"env": {
"STACKHAWK_API_KEY": "<YOUR_STACKHAWK_API_KEY>"
}
}
}
}VS CodeにStackHawk MCPをインストール
.vscode/mcp.json
{
"servers": {
"stackhawk-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"stackhawk-mcp"
],
"env": {
"STACKHAWK_API_KEY": "<YOUR_STACKHAWK_API_KEY>"
}
}
}
}VS Code CLIにStackHawk MCPをインストール
$ code --add-mcp '{"name":"stackhawk-mcp","type":"stdio","command":"uvx","args":["stackhawk-mcp"],"env":{"STACKHAWK_API_KEY":"<YOUR_STACKHAWK_API_KEY>"}}'Claude DesktopにStackHawk MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"stackhawk-mcp": {
"command": "uvx",
"args": [
"stackhawk-mcp"
],
"env": {
"STACKHAWK_API_KEY": "<YOUR_STACKHAWK_API_KEY>"
}
}
}
}CodexにStackHawk MCPをインストール
$ codex mcp add stackhawk-mcp --env 'STACKHAWK_API_KEY=<YOUR_STACKHAWK_API_KEY>' -- uvx stackhawk-mcpCodex config.tomlにStackHawk MCPをインストール
~/.codex/config.toml
[mcp_servers.stackhawk-mcp] command = "uvx" args = ["stackhawk-mcp"] [mcp_servers.stackhawk-mcp.env] STACKHAWK_API_KEY = "<YOUR_STACKHAWK_API_KEY>"
Gemini CLIにStackHawk MCPをインストール
$ gemini mcp add -s user -e 'STACKHAWK_API_KEY=<YOUR_STACKHAWK_API_KEY>' stackhawk-mcp uvx -- stackhawk-mcpGemini settings.jsonにStackHawk MCPをインストール
~/.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 | 必須シークレット |
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能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/ ↗合格
- オープンソースライセンス (OSI)No license検出事項
- 過去1年以内にコミットまたはリリースあり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
GitHubで見るStackHawk 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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
StackHawk MCP serverで何ができますか?
プロジェクトの検出、StackHawkアプリケーションの作成、設定ファイルの生成、セキュリティスキャンの実行、および修正のための検出結果のトリアージが可能です。
StackHawk MCP serverをインストールするにはどうすればよいですか?
pip install stackhawk-mcpコマンドを使用して、pip経由でインストールできます。
このサーバーのシステム要件は何ですか?
Python 3.10以上が必要です。