# semaphore-mcp

MCP server for SemaphoreUI Ansible automation.

Source: [`cloin/semaphore-mcp`](https://github.com/cloin/semaphore-mcp)

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `SEMAPHORE_URL` | Yes | Base URL of the SemaphoreUI instance (e.g. `https://semaphore.corentic.eu`) |
| `SEMAPHORE_API_TOKEN` | Yes | API token from SemaphoreUI user settings |
| `MCP_PORT` | No | Port for the MCP HTTP server (default: `8000`, overridden to `8103`) |
| `MCP_TRANSPORT` | No | Transport mode (`http` or `stdio`, default: `http`) |
| `MCP_HOST` | No | Bind address (default: `0.0.0.0`) |

## Usage

```bash
docker run -d \
  --name semaphore-mcp \
  -p 8103:8103 \
  -e SEMAPHORE_URL=https://semaphore.corentic.eu \
  -e SEMAPHORE_API_TOKEN=your_token \
  forgejo.corentic.eu/corentic/mcp-fleet-semaphore:latest
```

This MCP uses native HTTP transport (no mcp-proxy). Connect via SSE at `http://host:8103/mcp`.

## Tools

Projects, templates, schedules, tasks, environments, inventory, repositories, access keys (98+ tools).