# omp-mcp

MCP (Model Context Protocol) server wrapping [Oh My Pi](https://github.com/can1357/oh-my-pi) built-in tools — `read`, `write`, `edit`, `bash`, `grep`, `glob`, `hub`, `task`, and more — as MCP tools.

## Prerequisites

- [Bun](https://bun.sh) >= 1.2
- Git

## Quick Start

```bash
# 1. Clone vendor dependency
make clone-vendor

# 2. Install dependencies
make install

# 3. Start the server
make start
```

Server listens on `http://127.0.0.1:8080/mcp`.

## Configuration

Edit mode defaults to `replace` (simpler for MCP clients). Generate a config file to customize:

```bash
make config
# edit config.yml, then:
make start-config
```

Available settings — see `vendor/oh-my-pi/packages/coding-agent/src/config/settings-schema.ts`. Common overrides:

```yaml
# Edit mode: replace, hashline, patch, apply_patch
edit.mode: replace

# Tool approval: yolo (auto-all), write (prompt exec), always-ask (prompt write+exec)
tools.approvalMode: yolo
```

## Usage

Add to your MCP client config (`mcp.json` or equivalent):

```json
{
  "mcpServers": {
    "omp-mcp": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `read` | Read files, directories, archives, SQLite, URLs |
| `write` | Write files, archive entries, SQLite rows |
| `edit` | Edit files (replace mode by default) |
| `bash` | Execute shell commands |
| `grep` | Regex search |
| `glob` | File globbing |
| `hub` | Agent coordination |
| `task` | Delegate work to subagents |
| `browser` | Drive headless Chromium |
| `web_search` | Web search |
| `eval` | Run JS/Python code |
| ... | (and more) |

## Makefile Targets

| Target | Description |
|--------|-------------|
| `clone-vendor` | Clone oh-my-pi into `vendor/` (first time) |
| `install` | Install dependencies |
| `start` | Run server (port 8080) |
| `start-config` | Run server with `config.yml` |
| `start-port PORT=9090` | Run server on custom port |
| `config` | Generate default `config.yml` |
| `dev` | Run in watch mode |
| `check` | Type-check with tsc |
| `vendor` | Install vendor dependencies |
| `vendor-native` | Build native vendor packages |

## Env Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `OMP_MCP_CWD` | `process.cwd()` | Working directory for tools |
| `OMP_MCP_CONFIG` | — | Path to config YAML |