How cobalt-strike/cobaltstrike-mcp-server works
Cobalt Strike MCP Server bridges MCP clients to a running Cobalt Strike REST API, exposing a curated tool catalog, resources, prompts, Beacon interpreter helpers, downloaded-file access, and optional WebSocket-backed console output. The primary workflow is an MCP client invoking a published tool; the server routes it through a query/custom helper or generated OpenAPI operation, and the authenticated client calls the Cobalt Strike API. The launcher configures and starts the server. Edges reflect README statements and shown excerpts or SOURCE INDEX references; unsampled details are not expanded.
Main entry points: cs_server.py MCP server · cs_files.py Downloaded files · cs_client.py Authenticated API client · cs_interpreter.py Beacon interpreter
Components 18
Server entry
- Launcher
cs_mcp.py - MCP server
cs_server.py
MCP capabilities
- REST tool catalog
cs_openapi.py - Grouped queries
cs_queries.py - Beacon interpreter
cs_interpreter.py - Downloaded files
cs_files.py - Document extraction
cs_documents.py - MCP resources
cs_resources.py - MCP prompts
cs_prompts.py - WebSocket streams
cs_streams.py
Cobalt Strike integration
- Authenticated API client
cs_client.py
Response and audit
- Tool contracts
cs_tool_contracts.py - Result shaping
cs_results.py - Untrusted content marking
cs_content_safety.py - Audit logging
cs_audit.py
Other components
- MCP client
- Cobalt Strike API
- Cobalt Strike WebSocket
Connections 26
- MCP client → MCP server: invokes tools
README.md - Launcher → MCP server: starts
cs_mcp.py - MCP server → REST tool catalog: builds tools from
cs_server.py - MCP server → Grouped queries: registers
cs_server.py - MCP server → Beacon interpreter: registers
cs_server.py - MCP server → Downloaded files: registers
cs_server.py - MCP server → MCP resources: registers
cs_server.py - MCP server → MCP prompts: registers
cs_server.py - MCP server → WebSocket streams: configures
cs_server.py - MCP server → Tool contracts: validates catalog
cs_server.py - MCP server → Authenticated API client: uses
cs_server.py - Grouped queries → REST tool catalog: invokes handlers
cs_queries.py - REST tool catalog → Authenticated API client: sends API requests
README.md - Beacon interpreter → Authenticated API client: submits interpreter requests
cs_interpreter.py - Downloaded files → Authenticated API client: fetches downloads
cs_files.py - Downloaded files → Document extraction: extracts document text
cs_files.py - MCP resources → Authenticated API client: requests API data
cs_resources.py - Authenticated API client → Cobalt Strike API: authenticates and requests
cs_client.py - WebSocket streams → Cobalt Strike WebSocket: subscribes
- Beacon interpreter → WebSocket streams: uses console output
cs_interpreter.py - Downloaded files → Result shaping: formats tool results
cs_files.py - Beacon interpreter → Result shaping: formats tool results
cs_interpreter.py - WebSocket streams → Untrusted content marking: marks returned content
cs_streams.py - Downloaded files → Untrusted content marking: marks returned content
cs_files.py - Beacon interpreter → Audit logging: records invocations
cs_interpreter.py - Downloaded files → Audit logging: records invocations
cs_files.py