Add to Cursor

Жми кнопку в любом браузере, где установлен Cursor — он перехватит deeplink, покажет диалог подтверждения и сам пропишет сервер в ~/.cursor/mcp.json.

Или скопируй официальный Cursor deeplink:

cursor://anysphere.cursor-deeplink/mcp/install?name=taskagent&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHA6Ly9sb2NhbGhvc3Q6ODA4MC92MS9tY3AifQ%3D%3D

Default-путь Cursor использует HTTP MCP endpoint TaskAgent. Для локальной разработки сначала запусти сервер:

./target/release/taskagent-server   # данные: ~/.agents/taskagent/data

Что делает

taskagent-cursor — тонкий компаньон Cursor для tupical/taskagent. Делает три вещи:

1. Регистрирует MCP-сервер в mcp.json Cursor — глобально (~/.cursor/mcp.json) или для проекта (./.cursor/mcp.json).
2. Генерирует ссылку «Add to Cursor» для установки HTTP MCP в один клик.
3. Кладёт три правила в .cursor/rules/, которые учат агента Cursor работать с taskagent_*-инструментами (parse → decompose → plan → execute) вместо самодельных тудушек и держат его на экономном пути list active:
   • taskagent-policy.mdc (alwaysApply) — taskagent как трекер по умолчанию + правила экономии токенов (list-first, без graph-поиска для инвентаря).
   • taskagent.mdc — полный контракт инструментов + audit/close workflow.
   • workspacegraph.mdc — guardrails: taskagent_workspacegraph_* для связей/impact, а не для списка открытых задач.

Сам по себе плагин не содержит логики исполнения. Cursor-агент общается с сервером taskagent напрямую через MCP — здесь только обвязка.

Установка

Через npm

npm i -g taskagent-cursor
taskagent-cursor install --global   # пишет ~/.cursor/mcp.json
taskagent-cursor doctor             # проверка

Вручную

Скопируй cursor/mcp.example.json в ~/.cursor/mcp.json (или влей запись taskagent в существующий файл).

CLI

| Команда | Эффект | | ---------------------------------------------------------------- | ----------------------------------------------------------------------- | | taskagent-cursor install [--global\|--project DIR] | Прописать taskagent MCP в выбранный mcp.json. | | taskagent-cursor uninstall [--global\|--project DIR] | Удалить запись. | | taskagent-cursor deeplink [--print-scheme] | Напечатать официальный Cursor Add-to-Cursor deeplink. | | taskagent-cursor rules [--project DIR] [--force] | Положить три .cursor/rules/*.mdc (policy + контракт + workspacegraph) в проект. | | taskagent-cursor doctor [--json\|--quiet] | Проверить Cursor MCP config + HTTP-сервер. Exit 0 ⇒ READY. | | taskagent-cursor setup | Подсказки по установке отсутствующего. | | taskagent-cursor marketplace | Напечатать plugin-манифест taskagent (со встроенным актуальным deeplink). | | taskagent-cursor --version / --help | |

Флаги install

| Флаг | По умолчанию | Заметки | | ---------------------------- | -------------------------- | ----------------------------------------------------------- | | --global / --project DIR | --global | В какой mcp.json писать. | | --transport http\|stdio | http | Cursor по умолчанию использует hosted HTTP MCP. | | --command CMD | (нет) | Включает stdio fallback и задаёт путь к бинарю. | | --base-url URL | http://localhost:8080 | Origin HTTP MCP сервера. | | --token T | (нет) | Добавляет Authorization header для self-host config. | | --name NAME | taskagent | Переименовать запись (если запускаешь несколько инстансов). |

Как работает deeplink-flow

deeplink                                                Cursor
┌─────────────────────────┐    cursor://...  ┌─────────────────────┐
│ taskagent               │ ───────────────▶ │ «Установить MCP?»   │
│ [ Add to Cursor ]       │   deeplink       │ пишет mcp.json      │
└─────────────────────────┘                  └─────────────────────┘
        │
        │ использует /clients/cursor-plugin/.taskagent-plugin/plugin.json
        │ из этого репо (или npm-тарбола)
        ▼
┌─────────────────────────┐
│ manifest маркетплейса   │
│  name, version, deeplink│
│  install hints, rules   │
└─────────────────────────┘

Формат deeplink — официальный Cursor MCP install link:

cursor://anysphere.cursor-deeplink/mcp/install?name=<NAME>&config=<BASE64_JSON>

config — base64 от JSON-объекта с одной записью mcpServers. Сгенерировать свой:

taskagent-cursor deeplink

Структура

clients/cursor-plugin/
├── package.json                          # npm-пакет + CLI bin
├── bin/taskagent-cursor.mjs       # точка входа CLI
├── lib/
│   ├── deeplink.mjs                      # генератор cursor:// install link
│   ├── detect.mjs                        # readiness-проба Cursor + taskagent
│   ├── mcp-config.mjs                    # чтение/запись ~/.cursor/mcp.json
│   └── rules.mjs                         # установка .cursor/rules/*.mdc
├── cursor/
│   ├── mcp.example.json                  # эталон для ручной установки
│   └── rules/                            # policy + контракт + workspacegraph guardrails
│       ├── taskagent-policy.mdc          # alwaysApply policy (list-first / экономия токенов)
│       ├── taskagent.mdc                 # контракт + audit/close workflow
│       └── workspacegraph.mdc            # граф-инструменты: связи/impact, не инвентарь
├── .taskagent/plugin.json                   # манифест маркетплейса taskagent
└── tests/                                # node --test

Требования

• Cursor (любой свежий, с поддержкой MCP)
• Node.js ≥ 20 (только для CLI; в рантайме не нужен)
• Запущенный taskagent HTTP server. Для локальной разработки собери его из tupical/taskagent: cargo build --release -p taskagent-server.
• taskagent-mcp нужен только для явного fallback --transport stdio.

Лицензия

MIT — см. LICENSE.