Photon CLI
Photon превращает один TypeScript-файл в MCP-сервер, CLI и веб-интерфейс Beam, а при росте добавляет расписания и аудит.
- 100 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Расписания, вебхуки и веб-маршруты исполняют код вашего инструмента без участия человека.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/photonОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Расписания, вебхуки и веб-маршруты исполняют код вашего инструмента без участия человека.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Photon берет небольшой проверенный метод на TypeScript и выводит вокруг него все интерфейсы. Из одной возможности получается MCP-сервер для Claude, ChatGPT и Cursor, встроенный интерфейс для клиентов с MCP-приложениями, CLI для скриптов и веб-интерфейс Beam для людей. Когда возможность вырастает в рабочий процесс, добавляются веб-маршруты, расписания, вебхуки, повторы, состояние и история аудита. Начало занимает две минуты: `photon new my-tool` создает заготовку, `photon` открывает Beam, `photon mcp install my-tool` подключает ту же возможность к Claude Desktop или другому клиенту MCP. Установка идет через `bun add -g @portel/photon`, а `photon mcp hello` запускает сервер для Claude и Cursor.
Для кого. Разработчикам, которые пишут свои инструменты для агентов на TypeScript и хотят получить MCP, CLI и интерфейс из одного файла.
Подходит, если
- Нужен собственный MCP-сервер для Claude и Cursor без отдельного шаблона проекта.
- Одну функцию надо сразу запустить из командной строки и из чата.
- Инструменту агента нужны расписание, вебхуки и журнал аудита.
- Коллегам нужен веб-интерфейс к инструменту, который уже работает как MCP.
Не подходит, если
- Нужен готовый MCP-сервер к сторонней службе, а писать код не требуется.
- Проект написан не на TypeScript.
- Нужна полностью стабильная и неизменная версия API.
Пример запроса к агенту
Создай инструмент photon для получения погоды по городу и подключи его к Claude Desktop как MCP-сервер.Ограничения
Photon требует Node.js или Bun и подходит для инструментов на TypeScript. Он порождает интерфейсы по описанию метода, поэтому качество MCP-инструмента зависит от того, как вы описали параметры и контракт. Расписания, вебхуки и веб-маршруты расширяют то, что может делать ваш код, поэтому ограничьте их права и проверяйте содержимое запросов. Встроенные приложения работают только в клиентах, которые поддерживают ресурсы MCP-приложений.
Как отключить. Удалите пакет командой `bun remove -g @portel/photon` и запись сервера из настроек MCP-клиента. Созданные вами файлы инструментов остаются в проекте.
Частые вопросы
С чего начать?
`bun add -g @portel/photon`, затем `photon new my-tool` и `photon` для открытия интерфейса Beam.
Как подключить к Claude?
Командой `photon mcp install my-tool`, она добавляет возможность в Claude Desktop или другой MCP-клиент.
Что такое Beam?
Веб-интерфейс для людей, который Photon строит из описания возможности.
Бесплатен ли Photon?
Да, это открытый проект под лицензией MIT.
Какие клиенты поддерживаются?
Claude, ChatGPT, Cursor и другие клиенты MCP, а встроенные интерфейсы работают в клиентах с MCP-приложениями.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI создает каркас MCP-сервера на TypeScript, добавляет компоненты и проверяет описания схем перед подключением
CLI и TypeScript-рантайм для вызова MCP-серверов из терминала, скриптов и сгенерированных типизированных клиентов
Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их
MCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов
Прозрачный прокси между ИИ-клиентом и MCP-сервером: показывает каждый кадр JSON-RPC в терминале, проверяет запись в CI и экспортирует спаны
Клиент в терминале и браузере открывает чат с моделью Anthropic и любым MCP-сервером, чтобы проверить его инструменты.
Коротко о README
Описание подает Photon как способ вывести из одной возможности весь стек агента: MCP, интерфейс, CLI и Beam. Дальше идут быстрый старт, описание поверхностей и ссылки на документацию.