# strudel-mcp

MCP server that exposes [Strudel](https://strudel.cc/) reference documentation as tools for AI coding assistants (Claude Code, Cursor, Cline, Windsurf, etc.).

Built on top of [strudel-docs-for-ai](https://github.com/auto-duan/strudel-docs-for-ai) — 111 functions documented and verified against official sources.

## Tools

| Tool | Description |
|---|---|
| `strudel_function` | Full docs for a function by name or alias (`cutoff` → `lpf`) |
| `strudel_search` | Search by name / category / tag |
| `strudel_list` | List all functions, optionally by category |
| `strudel_cheatsheet` | High-density syntax reference |
| `strudel_gotchas` | Common mistakes and counterintuitive behaviors |
| `strudel_mini_notation` | Complete mini-notation DSL reference |

## Setup

### 1. Clone and install

```bash
git clone https://github.com/auto-duan/strudel-mcp
cd strudel-mcp
npm install
```

### 2. Sync docs

The docs are bundled in `docs/`. To refresh from the source repo:

```bash
# If strudel-docs-for-ai is a sibling directory (default):
npm run sync-docs

# Or point to a custom path:
node scripts/sync-docs.js /path/to/strudel-docs-for-ai
```

### 3. Build

```bash
npm run build
```

### 4. Add to your AI tool

#### Claude Code

Add to `.claude/settings.json` (project) or `~/.claude/settings.json` (global):

```json
{
  "mcpServers": {
    "strudel": {
      "command": "node",
      "args": ["/absolute/path/to/strudel-mcp/dist/index.js"]
    }
  }
}
```

#### Cursor / Windsurf / Cline

Add to your MCP config (usually `~/.cursor/mcp.json` or similar):

```json
{
  "mcpServers": {
    "strudel": {
      "command": "node",
      "args": ["/absolute/path/to/strudel-mcp/dist/index.js"]
    }
  }
}
```

## Docs source

- Docs repo: https://github.com/auto-duan/strudel-docs-for-ai
- Official Strudel: https://strudel.cc/
- Official repo: https://codeberg.org/uzu/strudel