mcp-prompts

Хранилище шаблонов промптов с поиском и подстановкой переменных, плюс скрипт, который запускает агентов Claude по всему проекту.

  • 120 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Сервер читает и меняет JSON-каталог промптов, а скрипт оркестрации вызывает Claude CLI в вашем проекте.
  • Загруженный промпт попадает в контекст агента как инструкция, поэтому чужие шаблоны стоит читать до применения.
Все причины и проверки

sparesparrow/mcp-prompts

Установка

Ручная установка

npm install -g @sparesparrow/mcp-prompts

Команда из README; GitHub Packages просит токен `read:packages`, npm работает без него.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Сервер читает и меняет JSON-каталог промптов, а скрипт оркестрации вызывает Claude CLI в вашем проекте.
  • Загруженный промпт попадает в контекст агента как инструкция, поэтому чужие шаблоны стоит читать до применения.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

MCP-сервер хранит промпты и конфигурации агентов в JSON-файлах каталога `data/prompts/` и отдает их любому MCP-клиенту. Семь инструментов (`list_prompts`, `get_prompt`, `add_prompt`, `update_prompt`, `delete_prompt`, `apply_template` и `get_stats`) ищут по тегам и тексту, добавляют промпты и подставляют значения в `{{переменные}}` шаблонов. В пакет уже входят готовые наборы: девять главных агентов под типы проектов, подагенты для разбора архитектуры, безопасности и тестов, когнитивные слои и доменные заготовки. Скрипт `scripts/orchestrate-project.sh` определяет тип проекта, подгружает нужного агента и вызывает Claude CLI. Те же промпты доступны по JSON API в HTTP-режиме.

Для кого. Командам и одиночкам, которые держат шаблоны промптов и ролей агентов в одном месте и хотят подключать их из Claude Code, Claude Desktop или Cursor.

Подходит, если

  • Шаблон промпта с переменными заполняют по запросу, например путь к прошивке.
  • Агенту нужно показать все промпты с тегом `orchestration`.
  • Проект разбирают целиком: скрипт выбирает главного агента по типу проекта и запускает подагентов.
  • Не-MCP клиент берет те же промпты по HTTP из `/v1/prompts`.

Не подходит, если

  • Промпты нужно хранить постоянно прямо через `add_prompt`: такие записи живут в памяти и пропадают при перезапуске.
  • Нужна многопользовательская платформа с оплатой: AWS-вариант убран в `archive/aws`.
  • Хватит одного файла с инструкциями в проекте.

Пример запроса к агенту

Покажи все промпты с тегом orchestration и примени шаблон claudepy-esp32-android-bridge-workflow, подставив esp32_firmware_path равным ./firmware.

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

PROMPTS_DIR
Каталог с JSON-промптами вместо встроенного.

Ограничения

Промпты, добавленные или измененные через `add_prompt`, `update_prompt` и HTTP, хранятся в памяти и теряются при перезапуске. Постоянный промпт — это JSON-файл в `data/prompts/` с устойчивым id, который добавляют через pull request. Установка из GitHub Packages требует токен с правом `read:packages` в `~/.npmrc`, иначе придет `401 Unauthorized`. Из npm пакет ставится без токена. Скрипт оркестрации вызывает Claude CLI, поэтому он тратит лимиты Claude и меняет файлы по правам агента.

Как отключить. Удалите сервер командой `claude mcp remove mcp-prompts` и выполните `npm uninstall -g @sparesparrow/mcp-prompts`. Если запускали HTTP-режим, остановите процесс или контейнер.

Частые вопросы

Как подключить mcp-prompts к Claude Code?

Поставьте пакет `npm install -g @sparesparrow/mcp-prompts`, затем выполните `claude mcp add -s user mcp-prompts -- mcp-prompts`. Проверить подключение можно командой `claude mcp list`.

Где хранятся промпты?

В JSON-файлах `data/prompts/`. Свой каталог задается переменной `PROMPTS_DIR`. Промпты, добавленные через инструменты, живут только в памяти.

Есть ли HTTP-интерфейс?

Да. Команда `pnpm start:http` (или `npx mcp-prompts-http`) поднимает JSON API на порту 3003 с путями `/v1/prompts`, `/health` и `/mcp/tools`.

Какие инструменты MCP есть?

`list_prompts`, `get_prompt`, `add_prompt`, `update_prompt`, `delete_prompt`, `apply_template` и `get_stats`. Для шаблонов с `{{переменными}}` нужен `apply_template`.

Что делает скрипт оркестрации?

`./scripts/orchestrate-project.sh ~/projects/mia analyze` определяет тип проекта, загружает главного агента, запускает подагентов через Claude CLI и возвращает структурированный результат.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

MCP-сервер с шаблонами промптов, цепочками шагов и проверкой вывода: экспорт в навыки Claude Code, Cursor и Codex

MCP-серверРасширенный доступ192Звезды репозитория

PromptOps держит Claude Code, Codex и Gemini CLI рядом по проектам и дает ведущему агенту MCP для запуска помощников

CLIШирокий доступ70Звезды репозитория
Выбор редакции

Открытая библиотека промптов с плагином Claude Code, MCP-сервером и CLI: поиск, получение и улучшение промптов и скиллов из агента

ПлагинРасширенный доступ177 тыс.Звезды репозитория

CLI, который на лету превращает любой MCP-сервер, спецификацию OpenAPI или GraphQL-эндпоинт в набор команд без генерации кода

CLIШирокий доступ2,4 тыс.Звезды репозитория

Универсальный CLI-клиент MCP от Apify: постоянные сессии, OAuth, JSON-вывод для скриптов и доступ агента к любому MCP-серверу через оболочку

CLIШирокий доступ1,1 тыс.Звезды репозитория

Шаблоны промптов для ИИ-агентов программирования, написанные независимо: системные, для инструментов, делегирования, памяти и работы нескольких агентов

ПромптМинимальный доступ1,2 тыс.Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
mcp-prompts (эта карточка)нетне нужна120
prompts.chatнет176 985открытая библиотека промптов с плагином и CLI; здесь локальный сервер с шаблонами и скриптом оркестрации
PromptScript — правила для всех ИИ-агентов из одного источниканет344компилирует правила и скиллы в файлы разных агентов; mcp-prompts отдает готовые промпты по запросу

Коротко о README

Сервер в npm-пакете читает JSON-файлы напрямую и общается по stdio. Полная гексагональная версия с адаптерами хранилищ лежит в `src/mcp/mcp-server.ts`, а старые AWS-компоненты перенесены в архив.

Бейдж для README

Сообщить о проблеме