mirror of
https://github.com/storytold/wordcraft.git
synced 2026-10-28 20:37:10 -06:00
33 lines
1.4 KiB
Markdown
33 lines
1.4 KiB
Markdown
# MCP server
|
|
|
|
WordCraft speaks the [Model Context Protocol](https://modelcontextprotocol.io) over stdio, so
|
|
Claude and other agents can write and edit documents.
|
|
|
|
```sh
|
|
wordcraft-cli mcp # headless session (no window)
|
|
wordcraft --control 7981 & # or: drive the running app…
|
|
wordcraft-cli mcp --connect 127.0.0.1:7981 # …including clicks, keys and screenshots
|
|
```
|
|
|
|
Claude Code: `claude mcp add wordcraft -- wordcraft-cli mcp`.
|
|
|
|
## Tools
|
|
|
|
| Tool | What it does |
|
|
|---|---|
|
|
| `list_commands` | every command (filter with `query`) — over 270 of them |
|
|
| `execute` | run one command: `{command: "insert.table", params: {rows: 3, cols: 4}}` |
|
|
| `batch` | run several commands in order |
|
|
| `new_document` | blank, sample, letter, resume, report |
|
|
| `open_document` / `save_document` | docx, odt, rtf, html, md, txt, json; save also pdf, png |
|
|
| `type_text` | type at the caret (`paragraphs: true` splits lines into paragraphs) |
|
|
| `select_text` | select the n-th occurrence of some text |
|
|
| `get_text` / `inspect_document` | read the document back (verify without screenshots) |
|
|
| `render_page` | a page as PNG |
|
|
| `parity` | feature coverage |
|
|
| `screenshot`, `click`, `key`, `ui_inspect` | app only (`--connect`) |
|
|
|
|
Resources: `wordcraft://document` (inspect) and `wordcraft://commands`.
|
|
|
|
The acceptance test `crates/mcp/src/tests.rs` writes a formatted document using MCP only.
|