# homotope

The homotope MCP server integrates vectorization capabilities into AI assistants. It connects to homotope.app to process raster images into clean vector formats.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 repo stars
- Author: stevenroman91
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/stevenroman91/homotope-engine
- Updated: 2026-10-31
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/homotope

## What it does

The server bridges AI assistants with the homotope.app platform for image vectorization. Topology-first processing converts pixels into paths without overlapping boundaries or gaps. Presets handle logos, illustrations, line art, and fabrication exports.

The integration relies on an HTTP connection to the remote homotope.app service. Claude Code mounts the server via the specified transport protocol command.

## Requirements
- Remote server: `https://homotope.app/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http homotope https://homotope.app/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add homotope --url https://homotope.app/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "homotope": {
            "url": "https://homotope.app/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "homotope": {
            "type": "http",
            "url": "https://homotope.app/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http homotope https://homotope.app/mcp
```

## When to use it
- vectorize raster image into SVG
- convert vector output to DXF
- check SVG readiness for laser cutting
- extract colour palette from image

## Example prompts
- Connect the homotope MCP server for image vectorization
- Vectorize `logo.png` into SVG format using homotope
- Check the vector file for cutter readiness

## Similar
- [Vectorize](https://affpapa.org/en/nevibecode/mcp/vectorize.md) — MCP server
- [OpenCalque](https://affpapa.org/en/nevibecode/mcp/opencalque.md) — MCP server · ★ 128 repo stars
- [KerfScript](https://affpapa.org/en/nevibecode/mcp/kerfscript.md) — MCP server · ★ 11 repo stars
- [scenario-brand-kit](https://affpapa.org/en/nevibecode/skills/scenario-brand-kit.md) — skill · 870 installs
- [create-svg-illustrations](https://affpapa.org/en/nevibecode/skills/create-svg-illustrations.md) — skill · 211 installs
- [recraft-image-design](https://affpapa.org/en/nevibecode/skills/recraft-image-design.md) — skill · 140 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
