Metadata-Version: 2.4
Name: atomic-red-team-mcp
Version: 1.0.1
Summary: MCP server providing access to Atomic Red Team security tests with search, validation, and creation capabilities
Project-URL: Homepage, https://github.com/cyberbuff/atomic-red-team-mcp
Project-URL: Documentation, https://github.com/cyberbuff/atomic-red-team-mcp
Project-URL: Repository, https://github.com/cyberbuff/atomic-red-team-mcp
Project-URL: Issues, https://github.com/cyberbuff/atomic-red-team-mcp/issues
Author: cyberbuff
License-Expression: MIT
License-File: LICENSE
Keywords: atomic-red-team,mcp
Requires-Python: >=3.10
Requires-Dist: gitpython>=3.1.0
Requires-Dist: mcp[cli]>=1.13.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0.2
Description-Content-Type: text/markdown

# Atomic Red Team MCP Server

An MCP (Model Context Protocol) server that provides access to Atomic Red Team tests.

## Available Tools and Resources

The server provides the following MCP tools:

- `query_atomics` - Search atomics by technique ID, name, description, or platform
- `refresh_atomics` - Download latest atomics from GitHub
- `validate_atomic` - Validate atomic test YAML
- `get_validation_schema` - Get the atomic test schema

And resources:
- `file://documents/{technique_id}` - Read atomic test files by technique ID

### Usage Examples

- "Search mshta atomics for windows"
- "Show me all the atomic tests for T1059.002"
- "Find all the applescript atomics for macOS"
- "Validate this atomic test YAML <yaml-content-here>"

## Installation

The Atomic Red Team MCP server can be installed in various development tools and AI assistants. Choose your platform below for detailed installation instructions:

### Quick Start

**Recommended: Using uvx**
```bash
uvx atomic-red-team-mcp
```

**Using Docker**
```bash
docker run --rm -i ghcr.io/cyberbuff/atomic-red-team-mcp:latest
```

### Platform-Specific Guides

- **[Claude Desktop & Claude Code](guides/claude.md)** - Installation guide for Anthropic's Claude Desktop app and Claude Code CLI
- **[Cursor](guides/cursor.md)** - Installation guide for Cursor IDE
- **[Windsurf](guides/windsurf.md)** - Installation guide for Windsurf editor
- **[Google AI Studio / Gemini](guides/gemini.md)** - Installation guide for Google's AI tools
- **[Other Tools](guides/other.md)** - Cline, Zed, Docker, Docker Compose, and generic MCP clients

### Installation Methods

Each platform supports multiple installation methods:

1. **uvx (Recommended)** - Easiest setup, automatic updates
2. **Docker** - Isolated environment, consistent across systems
3. **Remote Server** ⚠️ - Hosted on Railway (free tier, may have limits)

## Configuration

Environment variables:
- `MCP_TRANSPORT` - Transport protocol (stdio, sse, streamable-http)
- `MCP_HOST` - Host address to bind the server (default: 0.0.0.0)
- `MCP_PORT` - Port for HTTP transports (default: 8000)
- `GITHUB_URL` - GitHub URL for atomics repository (default: https://github.com)
- `GITHUB_USER` - GitHub user/org (default: redcanaryco)
- `GITHUB_REPO` - Repository name (default: atomic-red-team)
