# BomberJS MCP Server

<img src="https://atomic-bomb.io/assets/hero-bomber-mcp-v3-CLT9KA_6.png" />

BomberJS is the Node.js version of Bomber. It exposes the [`atomic_bomb`](https://atomic-bomb.io)
tool over HTTP and runs this command in the project root supplied by the
agent:

```sh
npx atomic-bomb --type <TYPE> --name <NAME> [--for <NAME>]
```

## Install and run

Requires Node.js 18 or newer.

```sh
npm install
npm start
```

The default MCP endpoint is:

```text
http://127.0.0.1:3042/mcp
```

Endpoints:

- `GET /`
- `GET /health`
- `POST /mcp`

## Configuration

BomberJS reads the first existing configuration file from:

```text
$XDG_CONFIG_HOME/bomber/config.toml
~/.config/bomber/config.toml
~/.bomber/config.toml
```

Example:

```toml
[server]
host = "127.0.0.1"
port = 3042

[atomic_bomb]
command = "npx"
package = "atomic-bomb"
```

Top-level `host`, `port`, `command`, and `package` keys are also accepted.
All fields are optional. The agent must provide `project_root` on every tool
call.

## MCP configuration

```json
{
  "mcpServers": {
    "bomber": {
      "url": "http://127.0.0.1:3042/mcp"
    }
  }
}
```

## Test

```sh
npm test
```