Promptheus — MCP-сервер для Claude Code: улучшает промпты через вопросы
MCP-сервер, который улучшает промпты через адаптивные уточняющие вопросы. Работает с шестью провайдерами: Google, Anthropic, OpenAI, Groq, Qwen, Zhipu.
claude mcp add promptheus -e GOOGLE_API_KEY=<GOOGLE_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> -e QWEN_API_KEY=<QWEN_API_KEY> -e GLM_API_KEY=<GLM_API_KEY> -- uvx promptheusЧто делает Promptheus
Promptheus анализирует исходный промпт и задаёт вопросы, чтобы уточнить аудиторию, тон, длину или ключевые требования. После ответов возвращает переработанный промпт. Сервер предоставляет два инструмента: refine_prompt для глубокой доработки с вопросами и tweak_prompt для точечных правок готового промпта.
Внутри — поддержка шести бэкендов (Gemini, Claude, GPT-4o, Llama через Groq, Qwen, GLM) и автороутинг через OpenRouter. Требуется хотя бы один ключ API из списка провайдеров. Команда uvx promptheus запускает сервер через uvx, Python 3.10+ обязателен.
Сервер может работать в режиме пропуска вопросов: тогда он сразу применяет оптимизацию без диалога. История промптов сохраняется локально, телеметрию можно отключить через переменную окружения PROMPTHEUS_TELEMETRY_ENABLED=0.
Какие задачи решает
- доработать промпт через уточняющие вопросы до запуска задачи
- переключать провайдера и модель в ходе сессии
- внести точечную правку в готовый промпт без пересборки
- проверить доступность провайдеров и корректность ключей API
- отследить историю промптов и переиспользовать прошлые версии
Примеры запросов агенту
- Уточни промпт «Напиши статью про async-программирование» и задай вопросы про аудиторию и тон
- Доработай промпт для технической документации, используй Gemini
- Внеси правку в промпт: добавь требование про длину ответа не больше 500 слов
Как установить Promptheus
Командой платформы
claude mcp add promptheus -e GOOGLE_API_KEY=<GOOGLE_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> -e QWEN_API_KEY=<QWEN_API_KEY> -e GLM_API_KEY=<GLM_API_KEY> -- uvx promptheusВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from promptheus <команда>
Командой платформы
codex mcp add promptheus --env GOOGLE_API_KEY=<GOOGLE_API_KEY> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env GROQ_API_KEY=<GROQ_API_KEY> --env QWEN_API_KEY=<QWEN_API_KEY> -- uvx promptheusВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from promptheus <команда>
Файл настроек
{
"mcpServers": {
"promptheus": {
"command": "uvx",
"args": [
"promptheus"
],
"env": {
"GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"GROQ_API_KEY": "<GROQ_API_KEY>",
"QWEN_API_KEY": "<QWEN_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from promptheus <команда>
Файл настроек
{
"servers": {
"promptheus": {
"type": "stdio",
"command": "uvx",
"args": [
"promptheus"
],
"env": {
"GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"GROQ_API_KEY": "<GROQ_API_KEY>",
"QWEN_API_KEY": "<QWEN_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from promptheus <команда>
Командой платформы
gemini mcp add -e GOOGLE_API_KEY=<GOOGLE_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> -e QWEN_API_KEY=<QWEN_API_KEY> promptheus uvx promptheusВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from promptheus <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Promptheus
Как установить Promptheus в Claude Code?
Выполни `claude mcp add promptheus -e GOOGLE_API_KEY=<GOOGLE_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> -e QWEN_API_KEY=<QWEN_API_KEY> -e GLM_API_KEY=<GLM_API_KEY> -- uvx promptheus`. Заполни ключи тех провайдеров, которые планируешь использовать.
Что делает Promptheus?
MCP-сервер улучшает промпты через адаптивные вопросы: определяет, какая информация нужна для задачи, задаёт вопросы и собирает переработанный промпт. Поддерживает шесть провайдеров LLM и позволяет переключаться между ними в ходе работы.
Какие провайдеры поддерживает Promptheus?
Google Gemini, Anthropic Claude, OpenAI GPT, Groq (Llama, Mixtral), Alibaba Qwen, Zhipu GLM и OpenRouter с автороутингом. Нужен хотя бы один ключ API из этого списка.
