Skip to content

feat: Add Shannon MCP Server for Claude Desktop Integration#135

Open
milog1994 wants to merge 3 commits intoKeygraphHQ:mainfrom
milog1994:claude/determined-shirley
Open

feat: Add Shannon MCP Server for Claude Desktop Integration#135
milog1994 wants to merge 3 commits intoKeygraphHQ:mainfrom
milog1994:claude/determined-shirley

Conversation

@milog1994
Copy link

Summary

This PR introduces a dedicated Shannon Desktop MCP Server to enable deep integration between Claude Desktop and the Shannon pentest infrastructure.

The new desktop-mcp-server package runs on the host machine and acts as a bridge, allowing Claude Desktop to:

  1. Control Dockerized Workflows: Start, stop, and monitor Temporal workflows via a direct gRPC connection to localhost:7233.
  2. Access Local Files: Read config files and audit logs directly from the host filesystem for low latency.
  3. Visualize Architecture: Includes an interactive playground (shannon-architecture-playground.html) to understand the data flow.

Key Features

  • New Package: desktop-mcp-server/ with its own package.json and tsconfig.json to keep dependencies clean.
  • MCP Tools:
    • start_scan: Launch scans with validation for URLs, repos, and configs.
    • query_progress: Real-time status checks of Temporal workflows.
    • get_report: Retrieve final markdown reports.
    • validate_config: Verify YAML configs against the schema.
  • Resources: Exposes audit-logs/, configs/, and deliverables/ as read-only resources.
  • Visualization: Added shannon-architecture-playground.html for architectural documentation.

Test Plan

  1. Run npm run build:mcp to verify compilation.
  2. Configure Claude Desktop with the new server:
    "shannon": {
      "command": "node",
      "args": ["/path/to/shannon/desktop-mcp-server/dist/index.js"],
      "env": { "SHANNON_ROOT": "..." }
    }
  3. Verify tools appear in Claude Desktop.
  4. Run a start_scan and check query_progress to confirm end-to-end connectivity with Docker.

🤖 Generated with Claude Code

vboi and others added 3 commits February 14, 2026 17:35
Add a new `desktop-mcp-server` package that runs on the host machine to bridge Claude Desktop with the Dockerized Shannon infrastructure.

Features:
- New MCP server using STDIO transport
- Tools: start_scan, query_progress, stop_scan, list_scans, get_report, validate_config
- Resources: audit-logs, configs, deliverables
- Direct Temporal gRPC connection to localhost:7233
- Host filesystem access for logs and configs

Changes:
- Add `desktop-mcp-server/` directory with source code
- Update root `package.json` with `build:mcp` script
- Update root `tsconfig.json` to exclude the new server package

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant