ok-script MCP
MCP-сервер помогает агенту создавать и проверять Python-задачи для управления приложениями Windows и устройствами Android.
- 827 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Подключенный агент может исполнять Python с правами процесса и читать или менять файлы.
- Сценарий управляет вводом в Windows или Android и может изменить данные целевого приложения.
Установка
- Работает в
Ручная установка
.\.venv\Scripts\python.exe -m pip install "ok-script[default]"Ставит пакет в `.venv` проекта Windows. Сначала создайте это виртуальное окружение и подготовьте конфигурацию целевого приложения; MCP входит в пакет с 2.0.17.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Подключенный агент может исполнять Python с правами процесса и читать или менять файлы.
- Сценарий управляет вводом в Windows или Android и может изменить данные целевого приложения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ok-script MCP дает агенту инструменты для снимков приложения и разработки автоматизации. Агент получает снимок приложения, читает встроенные инструкции, затем проверяет сигнатуры и исходники нужных функций установленного пакета. Затем он пишет Python-задачу и тестирует повторное выполнение. Сохраненную задачу запускают из интерфейса приложения или командной строки без нового обращения к модели. Для распознавания доступны шаблоны изображений и OCR, а для Android используется ADB. Сам сервер работает внутри настроенного проекта автоматизации.
Для кого. Для разработчиков и тестировщиков, которым нужны повторяемые сценарии управления своими Windows-приложениями или Android-устройствами.
Подходит, если
- Нужно один раз разработать сценарий интерфейса и многократно запускать его локально.
- Перед написанием задачи агент должен проверить реальные сигнатуры API установленной версии.
- Нужно сравнить снимки и шаблоны при разном разрешении экрана.
- Задачу требуется проверить с восстановлением исходного состояния интерфейса между попытками.
Не подходит, если
- Нужно взаимодействовать с чужим устройством без разрешения.
- Нельзя допустить автоматические нажатия в приложении с ценными данными.
- Требуется готовый сценарий без настройки целевого приложения.
Пример запроса к агенту
Проверь API моего проекта ok-script и подготовь повторяемый тест открытия настроек на отдельном тестовом устройстве.MCP
- Транспорт
- http
- Авторизация
- API-ключ
Ограничения
Для запуска нужен Python 3.11 или новее. Сервер запускается с конфигурацией конкретного приложения, поэтому один установленный пакет еще не дает готового сценария. Сохраняйте ограничения зависимостей проекта и выбирайте только один совместимый вариант OpenCV, чтобы не сломать захват изображения и распознавание. После изменения интерфейса целевого приложения проверяйте Python-задачу снова: прежние координаты или шаблоны могут выбрать другой элемент и изменить его данные.
Как отключить. Остановите процесс MCP и удалите его подключение из клиента. Сохраненные Python-задачи остаются в проекте и запускаются независимо, поэтому проверьте их отдельные расписания.
Частые вопросы
Где взять URL и токен соединения?
В актуальной записи `logs/mcp/connections/<pid>-<port>.json`. Клиент использует ее URL и заголовок авторизации; значения не нужно публиковать.
Есть ли отдельный поиск сигнатур API?
Нет. MCP поставляет скиллы и исполнительные инструменты, а сигнатуры агент проверяет по исходникам установленного пакета.
Нужна ли модель при каждом запуске готовой задачи?
Нет. Готовый Python-сценарий выполняет действия локально без обращения к агенту или модели.
Как выбрать встроенные инструкции разработки?
Вызовите `list_skills`, затем загрузите подходящий скилл через `get_skill`. Инструкции надо читать до разработки задачи.
Какая лицензия у ok-script?
Apache 2.0 с Commons Clause и дополнительными условиями. Нельзя напрямую продавать проект или слегка измененную копию, а в использующем его продукте нужна ссылка на ok-script; графические зависимости имеют свои лицензии.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и CLI wincli: агент управляет окнами Windows по именам кнопок и полей через UI Automation, без координат скриншота
MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell
MCP-сервер для AppleScript: агент запускает скрипты и управляет приложениями Mac, от заметок и календаря до файлов
Агент водит мышью, печатает текст, управляет окнами и снимает PNG-скриншоты рабочего стола Windows через AutoIt.
MCP-сервер для macOS на AppleScript: календарь, почта, сообщения, заметки, Finder, iTerm и Команды под управлением агента
MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API
Коротко о README
Пакет включает визуальную отладку шаблонов и средства упаковки задач. Снимки, журналы и результаты выполнения хранятся семь дней по умолчанию; скопируйте нужные файлы отдельно, если хотите сохранить их дольше.