| Name | atomic-red-team-mcp JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | MCP server providing access to Atomic Red Team security tests with search, validation, and creation capabilities |
| upload_time | 2025-08-17 03:30:15 |
| maintainer | None |
| docs_url | None |
| author | cyberbuff |
| requires_python | >=3.10 |
| license | None |
| keywords |
atomic-red-team
mcp
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Atomic Red Team MCP Server
An MCP (Model Context Protocol) server that provides access to Atomic Red Team tests.
## Installation
### Quick Start with uvx (Recommended)
The easiest way to run the Atomic Red Team MCP server is using `uvx`:
```bash
# Run directly without installation
uvx atomic-red-team-mcp
# Or install globally
uvx install atomic-red-team-mcp
atomic-red-team-mcp
```
### Install from PyPI
```bash
# Using pip
pip install atomic-red-team-mcp
# Using uv
uv add atomic-red-team-mcp
# Using pipx
pipx install atomic-red-team-mcp
```
### Using Docker
```bash
# Run the pre-built Docker container
docker run --rm -i -e MCP_TRANSPORT=stdio ghcr.io/cyberbuff/atomic-red-team-mcp:latest
```
## Usage
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
- `create_atomic_test` - Get guidance for creating new atomic tests
- `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
## Integration with Development Tools
### Claude Desktop
Add to your Claude Desktop configuration file:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
#### Option 1: Using uvx (Recommended)
```json
{
"mcpServers": {
"atomic-red-team": {
"command": "uvx",
"args": ["atomic-red-team-mcp"]
}
}
}
```
#### Option 2: Using Docker
```json
{
"mcpServers": {
"atomic-red-team": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "MCP_TRANSPORT=stdio",
"ghcr.io/cyberbuff/atomic-red-team-mcp:latest"
]
}
}
}
```
### Cursor
Add to your Cursor settings (`settings.json`):
#### Option 1: Using uvx (Recommended)
```json
{
"mcp.servers": {
"atomic-red-team": {
"command": "uvx",
"args": ["atomic-red-team-mcp"]
}
}
}
```
#### Option 2: Using Docker
```json
{
"mcp.servers": {
"atomic-red-team": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "MCP_TRANSPORT=stdio",
"ghcr.io/cyberbuff/atomic-red-team-mcp:latest"
]
}
}
}
```
### Cline (VS Code Extension)
Add to your Cline extension settings or `.cline_mcp_config.json`:
#### Option 1: Using uvx (Recommended)
```json
{
"mcpServers": {
"atomic-red-team": {
"command": "uvx",
"args": ["atomic-red-team-mcp"]
}
}
}
```
#### Option 2: Using Docker
```json
{
"mcpServers": {
"atomic-red-team": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "MCP_TRANSPORT=stdio",
"ghcr.io/cyberbuff/atomic-red-team-mcp:latest"
]
}
}
}
```
### Zed Editor
Add to your Zed settings (`settings.json`):
#### Option 1: Using uvx (Recommended)
```json
{
"experimental": {
"mcp": {
"servers": {
"atomic-red-team": {
"command": "uvx",
"args": ["atomic-red-team-mcp"]
}
}
}
}
}
```
#### Option 2: Using Docker
```json
{
"experimental": {
"mcp": {
"servers": {
"atomic-red-team": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "MCP_TRANSPORT=stdio",
"ghcr.io/cyberbuff/atomic-red-team-mcp:latest"
]
}
}
}
}
}
```
### Generic MCP Client
For any MCP client that supports stdio transport:
#### Using uvx (Recommended)
```bash
uvx atomic-red-team-mcp
```
#### Using Docker
```bash
docker run --rm -i -e MCP_TRANSPORT=stdio ghcr.io/cyberbuff/atomic-red-team-mcp:latest
```
### Docker
Run the pre-built Docker container:
```bash
docker run -d \
--name atomic-red-team-mcp-server \
-p 2786:8000 \
-e MCP_TRANSPORT=streamable-http \
-e MCP_PORT=8000 \
ghcr.io/cyberbuff/atomic-red-team-mcp:latest
```
The MCP server will be available at: `http://localhost:2786/mcp`
## Docker Compose
Alternatively, use the included docker-compose.yaml:
```bash
# Clone the repository
git clone <repository-url>
cd atomic-red-team-mcp
# Start the server
docker-compose up -d
```
## 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)
Raw data
{
"_id": null,
"home_page": null,
"name": "atomic-red-team-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "atomic-red-team, mcp",
"author": "cyberbuff",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/e0/a5/42d512d16198d63a19c6e634b3a9ec8547c530372145f98688c7752307ca/atomic_red_team_mcp-0.1.0.tar.gz",
"platform": null,
"description": "# Atomic Red Team MCP Server\n\nAn MCP (Model Context Protocol) server that provides access to Atomic Red Team tests.\n\n## Installation\n\n### Quick Start with uvx (Recommended)\n\nThe easiest way to run the Atomic Red Team MCP server is using `uvx`:\n\n```bash\n# Run directly without installation\nuvx atomic-red-team-mcp\n\n# Or install globally\nuvx install atomic-red-team-mcp\natomic-red-team-mcp\n```\n\n### Install from PyPI\n\n```bash\n# Using pip\npip install atomic-red-team-mcp\n\n# Using uv\nuv add atomic-red-team-mcp\n\n# Using pipx\npipx install atomic-red-team-mcp\n```\n\n### Using Docker\n\n```bash\n# Run the pre-built Docker container\ndocker run --rm -i -e MCP_TRANSPORT=stdio ghcr.io/cyberbuff/atomic-red-team-mcp:latest\n```\n\n## Usage\n\nThe server provides the following MCP tools:\n\n- `query_atomics` - Search atomics by technique ID, name, description, or platform\n- `refresh_atomics` - Download latest atomics from GitHub\n- `create_atomic_test` - Get guidance for creating new atomic tests\n- `validate_atomic` - Validate atomic test YAML\n- `get_validation_schema` - Get the atomic test schema\n\nAnd resources:\n- `file://documents/{technique_id}` - Read atomic test files by technique ID\n\n## Integration with Development Tools\n\n### Claude Desktop\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n#### Option 1: Using uvx (Recommended)\n```json\n{\n \"mcpServers\": {\n \"atomic-red-team\": {\n \"command\": \"uvx\",\n \"args\": [\"atomic-red-team-mcp\"]\n }\n }\n}\n```\n\n#### Option 2: Using Docker\n```json\n{\n \"mcpServers\": {\n \"atomic-red-team\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"--rm\", \"-i\",\n \"-e\", \"MCP_TRANSPORT=stdio\",\n \"ghcr.io/cyberbuff/atomic-red-team-mcp:latest\"\n ]\n }\n }\n}\n```\n\n### Cursor\n\nAdd to your Cursor settings (`settings.json`):\n\n#### Option 1: Using uvx (Recommended)\n```json\n{\n \"mcp.servers\": {\n \"atomic-red-team\": {\n \"command\": \"uvx\",\n \"args\": [\"atomic-red-team-mcp\"]\n }\n }\n}\n```\n\n#### Option 2: Using Docker\n```json\n{\n \"mcp.servers\": {\n \"atomic-red-team\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"--rm\", \"-i\",\n \"-e\", \"MCP_TRANSPORT=stdio\",\n \"ghcr.io/cyberbuff/atomic-red-team-mcp:latest\"\n ]\n }\n }\n}\n```\n\n### Cline (VS Code Extension)\n\nAdd to your Cline extension settings or `.cline_mcp_config.json`:\n\n#### Option 1: Using uvx (Recommended)\n```json\n{\n \"mcpServers\": {\n \"atomic-red-team\": {\n \"command\": \"uvx\",\n \"args\": [\"atomic-red-team-mcp\"]\n }\n }\n}\n```\n\n#### Option 2: Using Docker\n```json\n{\n \"mcpServers\": {\n \"atomic-red-team\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"--rm\", \"-i\",\n \"-e\", \"MCP_TRANSPORT=stdio\",\n \"ghcr.io/cyberbuff/atomic-red-team-mcp:latest\"\n ]\n }\n }\n}\n```\n\n### Zed Editor\n\nAdd to your Zed settings (`settings.json`):\n\n#### Option 1: Using uvx (Recommended)\n```json\n{\n \"experimental\": {\n \"mcp\": {\n \"servers\": {\n \"atomic-red-team\": {\n \"command\": \"uvx\",\n \"args\": [\"atomic-red-team-mcp\"]\n }\n }\n }\n }\n}\n```\n\n#### Option 2: Using Docker\n```json\n{\n \"experimental\": {\n \"mcp\": {\n \"servers\": {\n \"atomic-red-team\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"--rm\", \"-i\",\n \"-e\", \"MCP_TRANSPORT=stdio\",\n \"ghcr.io/cyberbuff/atomic-red-team-mcp:latest\"\n ]\n }\n }\n }\n }\n}\n```\n\n### Generic MCP Client\n\nFor any MCP client that supports stdio transport:\n\n#### Using uvx (Recommended)\n```bash\nuvx atomic-red-team-mcp\n```\n\n#### Using Docker\n```bash\ndocker run --rm -i -e MCP_TRANSPORT=stdio ghcr.io/cyberbuff/atomic-red-team-mcp:latest\n```\n\n### Docker\n\nRun the pre-built Docker container:\n\n```bash\ndocker run -d \\\n --name atomic-red-team-mcp-server \\\n -p 2786:8000 \\\n -e MCP_TRANSPORT=streamable-http \\\n -e MCP_PORT=8000 \\\n ghcr.io/cyberbuff/atomic-red-team-mcp:latest\n```\n\nThe MCP server will be available at: `http://localhost:2786/mcp`\n\n## Docker Compose\n\nAlternatively, use the included docker-compose.yaml:\n\n```bash\n# Clone the repository\ngit clone <repository-url>\ncd atomic-red-team-mcp\n\n# Start the server\ndocker-compose up -d\n```\n\n## Configuration\n\nEnvironment variables:\n- `MCP_TRANSPORT` - Transport protocol (stdio, sse, streamable-http)\n- `MCP_HOST` - Host address to bind the server (default: 0.0.0.0)\n- `MCP_PORT` - Port for HTTP transports (default: 8000)\n- `GITHUB_URL` - GitHub URL for atomics repository (default: https://github.com)\n- `GITHUB_USER` - GitHub user/org (default: redcanaryco)\n- `GITHUB_REPO` - Repository name (default: atomic-red-team)\n",
"bugtrack_url": null,
"license": null,
"summary": "MCP server providing access to Atomic Red Team security tests with search, validation, and creation capabilities",
"version": "0.1.0",
"project_urls": {
"Documentation": "https://github.com/cyberbuff/atomic-red-team-mcp",
"Homepage": "https://github.com/cyberbuff/atomic-red-team-mcp",
"Issues": "https://github.com/cyberbuff/atomic-red-team-mcp/issues",
"Repository": "https://github.com/cyberbuff/atomic-red-team-mcp"
},
"split_keywords": [
"atomic-red-team",
" mcp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7361cff004c1781b6d007d852ef724fa19b07afae840210c051f21a9df53703a",
"md5": "7a9ff285e52debdb959b72ef3acd99b5",
"sha256": "b9ce3c8cb5f4c3cf21b3dad0e061c5c56310903653234ab5d7a18108d5a4ce0c"
},
"downloads": -1,
"filename": "atomic_red_team_mcp-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7a9ff285e52debdb959b72ef3acd99b5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 11836,
"upload_time": "2025-08-17T03:30:14",
"upload_time_iso_8601": "2025-08-17T03:30:14.128933Z",
"url": "https://files.pythonhosted.org/packages/73/61/cff004c1781b6d007d852ef724fa19b07afae840210c051f21a9df53703a/atomic_red_team_mcp-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e0a542d512d16198d63a19c6e634b3a9ec8547c530372145f98688c7752307ca",
"md5": "8c4bc0b1179ce4d5fd2b8b384274d6e2",
"sha256": "e99fa00b9d773a2c4151e0eed900ac081ef509fbafd3cab77bee3a343b65276e"
},
"downloads": -1,
"filename": "atomic_red_team_mcp-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "8c4bc0b1179ce4d5fd2b8b384274d6e2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 11386,
"upload_time": "2025-08-17T03:30:15",
"upload_time_iso_8601": "2025-08-17T03:30:15.121481Z",
"url": "https://files.pythonhosted.org/packages/e0/a5/42d512d16198d63a19c6e634b3a9ec8547c530372145f98688c7752307ca/atomic_red_team_mcp-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-17 03:30:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cyberbuff",
"github_project": "atomic-red-team-mcp",
"github_not_found": true,
"lcname": "atomic-red-team-mcp"
}
