# ed-mcp

ed(1)-driven MCP server for git, gh, and fravia search.

Single-character command protocol. Minimal LLM output tokens.

## Protocol

```
FORMAT: <script>:<sequence>

SCRIPTS:
  g = git (local)
  h = gh (GitHub)
  s = search (fravia)
  ? = help

EXAMPLES:
  g:icp     = git init, commit, push
  h:np      = gh new repo, pr
  s:1t      = search phase 1, topic
  ?         = prints "?"
```

## Commands

### git (g)

| Char | Command |
|------|---------|
| i | git init |
| a | git add -A |
| c | git commit -s |
| p | git push |
| b | git branch |
| s | git status |
| l | git log |

### gh (h)

| Char | Command |
|------|---------|
| n | gh repo create |
| c | gh repo clone |
| p | gh pr create |
| i | gh issue create |
| s | gh repo sync |
| f | gh repo fork |

### search (s)

| Char | Meaning |
|------|---------|
| 1-8 | Fravia phase S1-S8 |
| t | Set topic |
| e | Select engine |
| c | Set codes |

## Installation

```sh
cd ed-mcp
bun install
```

## Usage

```sh
bun run start
```

## MCP Configuration

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "ed-mcp": {
      "command": "bun",
      "args": ["run", "start"],
      "cwd": "/path/to/ed-mcp"
    }
  }
}
```

## Philosophy

- ed(1) command convention
- Single-character responses
- Minimal output tokens
- POSIX sh scripts

## License

BSD-2-Clause