# capacitor-mcp

Даёт ассистенту актуальную документацию Capacitor, список плагинов и посты из блога Ionic. Пригодится, когда агент путает API плагинов и флаги CLI.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Автор: capawesome-team
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/capawesome-team/capacitor-mcp
- Обновлён: 2026-09-08
- HTML: https://affpapa.org/nevibecode/mcp/capacitor-mcp

## Что делает

Сервер хостится у Capawesome, ставить локально ничего не надо. Ассистент получает четыре инструмента: `search_docs` ищет по документации, `get_doc_page` открывает найденную страницу целиком, `list_plugins` выдаёт официальные и community-плагины, `list_blog_posts` показывает свежие записи блога Ionic. Документация доступна для Capacitor v8, v7, v6 и `next` — версию передают параметром `version` в `search_docs` и `get_doc_page`. По умолчанию берётся v8.

Подключение — одна строка в конфиге клиента. Для Claude это `claude mcp add --transport http capacitor-mcp https://capacitor-mcp.capawesome.io/mcp`. Клиенты без поддержки HTTP ходят через прокси-пакет `@capawesome/capacitor-mcp` по stdio, ему нужен Node.js 22 или новее.

Эндпоинт ограничен 100 запросами в минуту на IP. При превышении приходит `429 Too Many Requests`, помогает короткая пауза и повтор. IP обрабатывается только для этого лимита; сами запросы и аргументы инструментов не сохраняются и не используются для обучения. Проект неофициальный: с Ionic и OutSystems он не связан.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://capacitor-mcp.capawesome.io/mcp`

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http capacitor-mcp https://capacitor-mcp.capawesome.io/mcp
```

2. **Командой платформы**
```bash
claude mcp add capacitor-mcp -- npx -y @capawesome/capacitor-mcp
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add capacitor-mcp --url https://capacitor-mcp.capawesome.io/mcp
```

2. **Командой платформы**
```bash
codex mcp add capacitor-mcp -- npx -y @capawesome/capacitor-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "capacitor-mcp": {
            "url": "https://capacitor-mcp.capawesome.io/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "capacitor-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@capawesome/capacitor-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "capacitor-mcp": {
            "type": "http",
            "url": "https://capacitor-mcp.capawesome.io/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "capacitor-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@capawesome/capacitor-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http capacitor-mcp https://capacitor-mcp.capawesome.io/mcp
```

2. **Командой платформы**
```bash
gemini mcp add capacitor-mcp npx -y @capawesome/capacitor-mcp
```

## Когда брать
- уточнить сигнатуру метода плагина, не открывая браузер
- найти community-плагин под нужную задачу
- свериться с документацией конкретной версии Capacitor
- посмотреть, что нового писали в блоге Ionic
- прочитать страницу документации целиком по найденной ссылке

## Примеры запросов агенту
- Найди в документации Capacitor, как настроить push-уведомления
- Покажи список плагинов для работы с камерой
- Открой страницу документации про `CapacitorHttp` для версии v7

## Похожие
- [capacitor-keyboard](https://affpapa.org/nevibecode/skills/capacitor-keyboard.md) — скилл · 1000 установок
- [cordova-to-capacitor](https://affpapa.org/nevibecode/skills/cordova-to-capacitor.md) — скилл · 768 установок
- [ionic-enterprise-sdk-migration](https://affpapa.org/nevibecode/skills/capawesome-team-ionic-enterprise-sdk-migration.md) — скилл · 723 установки
- [ionic](https://affpapa.org/nevibecode/skills/ionic.md) — скилл · 797 установок
- [ionic-react](https://affpapa.org/nevibecode/skills/ionic-react.md) — скилл · 717 установок
- [otakit](https://affpapa.org/nevibecode/mcp/otakit.md) — MCP-сервер · ★ 46

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md