feat: Add Shannon MCP Server for Claude Desktop Integration#135
Open
milog1994 wants to merge 3 commits intoKeygraphHQ:mainfrom
Open
feat: Add Shannon MCP Server for Claude Desktop Integration#135milog1994 wants to merge 3 commits intoKeygraphHQ:mainfrom
milog1994 wants to merge 3 commits intoKeygraphHQ:mainfrom
Conversation
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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-serverpackage runs on the host machine and acts as a bridge, allowing Claude Desktop to:localhost:7233.shannon-architecture-playground.html) to understand the data flow.Key Features
desktop-mcp-server/with its ownpackage.jsonandtsconfig.jsonto keep dependencies clean.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.audit-logs/,configs/, anddeliverables/as read-only resources.shannon-architecture-playground.htmlfor architectural documentation.Test Plan
npm run build:mcpto verify compilation.start_scanand checkquery_progressto confirm end-to-end connectivity with Docker.🤖 Generated with Claude Code