Добавить сервер
kitao/pyxel-mcp
  1. Каталог MCP
  2. kitao/pyxel-mcp

kitao/pyxel-mcp

от kitao
MCP сервер для ретро-игрового движка Pyxel. AI-агенты запускают и анализируют Pyxel-программы без окна (headless) с изоляцией процессов и структурированным выводом. Полезен при создании игр на Python с LLM.
GithubPyPiСайт сервера

pyxel-mcp

Let AI agents play, watch, and measure Pyxel games. pyxel-mcp is an MCP server that runs a Pyxel script headlessly, feeds it scheduled input, stops when a condition holds, and hands back the facts: screenshots, pixel grids, game state, assets, audio, and frame diffs.

PyPI Python Tests License MCP Registry

Pyxel's bundled platformer example driven headlessly with right held and three scheduled jumps Frame 80 of the same run at scale 3, returned inline as image content

Both images come from one run call against Pyxel's bundled 10_platformer.py: 150 frames, right held from frame 0, jumps scheduled at frames 25, 70, and 110, a video snapshot, and an inline screen_image snapshot.

Why

An agent can write a Pyxel game in seconds, but it cannot open a window, press the arrow keys, or look at the screen. Editor-bound engines solve this with MCP servers that live inside the editor. Pyxel has no editor process to attach to, so pyxel-mcp drives the game itself:

  • Headless execution. Every call runs the script in a fresh subprocess with SDL dummy drivers and a frame budget. Set random_seed to seed Python's random module and Pyxel's random generator. Other randomness, timing, and external state can still affect the frames.
  • Input as data. Buttons, axes, and mouse position are scheduled per frame, so a playtest is a JSON document the agent can rerun and extend.
  • Stop on the event, not the clock. until="score >= 1" ends the run at the first frame where a game attribute holds, and "frame": "end" snapshots capture that moment.
  • Facts, not scores. Tools report pixels, values, and measurements. Deciding whether the game is good stays with the agent and the person asking for it.
  • See the frame in the result. inline: true returns a PNG as MCP image content, so the model looks at the screen without a second file read.

Часто задаваемые вопросы

Инструменты были проиндексированы:
diff_framesтолько чтениеидемпотентный

Сравнивает два PNG-кадра попиксельно и возвращает изменённую область и соотношение.

Параметры
  • frame_astringобязательный
  • frame_bstringобязательный
pyxel_infoтолько чтениеидемпотентный

Сообщает установленные версии, пути, примеры и URI ресурсов Pyxel.

Параметры

Без параметров.

read_audioвнешний мир

Рендерит один слот звука или музыки Pyxel в WAV и возвращает измеримые аудиоданные.

Параметры
  • output_pathstringобязательный
  • scriptstringобязательный
  • targetanyобязательный
read_imageвнешний мир

Читает пиксели с индексами палитры из области image bank в Pyxel и при необходимости рендерит их в PNG.

Параметры
  • hinteger | null
  • imageintegerобязательный
  • render_pathstring | null
  • scriptstringобязательный
  • winteger | null
  • xinteger
  • yinteger
read_paletteвнешний мир

Читает активную палитру Pyxel и индексы палитры, используемые банками изображений.

Параметры
  • scriptstringобязательный
read_tilemapвнешний мир

Считывает координаты тайла Pyxel, его использование, границы, исходный банк и необязательный отрендеренный вывод.

Параметры
  • render_pathstring | null
  • scriptstringобязательный
  • tilemapintegerобязательный
runвнешний мир

Запускает Pyxel-скрипт в headless-режиме на заданный бюджет кадров или до выполнения условия, с запланированным вводом и захватом состояния, экрана или видео.

Параметры
  • framesintegerобязательный
  • inputsany[] | null
  • random_seedinteger | null
  • scriptstringобязательный
  • snapshotsany[] | null
  • stall_window_framesinteger | null
  • timeoutinteger
  • untilstring | null
validateтолько чтениеидемпотентный

Проверить синтаксис Python и сообщить о распознаваемых шаблонах кода Pyxel.

Параметры
  • scriptstringобязательный
1.3.1основная
1.3.0
1.2.0
1.1.0
1.0.0
0.9.2
0.9.1
0.9.0
0.8.3
0.8.2
0.8.1
0.8.0
0.7.7
0.7.6
0.7.5
0.7.4
0.7.3
0.7.2
0.7.1
0.7.0
0.6.0
0.5.0
0.4.2
0.4.1
0.4.0
0.3.1
0.3.0
0.2.0
0.1.11
0.1.10
0.1.9
0.1.8
0.1.7
0.1.6
0.1.5
0.1.4
0.1.3
0.1.2
0.1.1
0.1.0

Выберите клиент, чтобы установить kitao/pyxel-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "kitao-pyxel-mcp-p46eitzwje": {
      "command": "uvx",
      "args": [
        "pyxel-mcp"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "kitao-pyxel-mcp-p46eitzwje": {
      "command": "uvx",
      "args": [
        "pyxel-mcp"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "kitao-pyxel-mcp-p46eitzwje": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pyxel-mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"kitao-pyxel-mcp-p46eitzwje\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"pyxel-mcp\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "kitao-pyxel-mcp-p46eitzwje": {
      "command": "uvx",
      "args": [
        "pyxel-mcp"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add kitao-pyxel-mcp-p46eitzwje -- uvx pyxel-mcp

Либо через JSON-конфиг:

claude mcp add-json kitao-pyxel-mcp-p46eitzwje "{\"command\":\"uvx\",\"args\":[\"pyxel-mcp\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add kitao-pyxel-mcp-p46eitzwje -- uvx pyxel-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.kitao-pyxel-mcp-p46eitzwje]
command = "uvx"
args = ["pyxel-mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите kitao/pyxel-mcp, а в поле команды запуска — строку ниже:
uvx pyxel-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "kitao-pyxel-mcp-p46eitzwje": {
      "command": "uvx",
      "args": [
        "pyxel-mcp"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "kitao-pyxel-mcp-p46eitzwje": {
      "command": "uvx",
      "args": [
        "pyxel-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например kitao-pyxel-mcp-p46eitzwje.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: kitao-pyxel-mcp-p46eitzwje
    command: uvx
    args:
      - "pyxel-mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "kitao-pyxel-mcp-p46eitzwje": {
      "command": "uvx",
      "args": [
        "pyxel-mcp"
      ]
    }
  }
}

Похожие MCP-сервера

iris-eval/mcp-server

iris-eval/mcp-server

от iris-eval

Iris - open-source MCP сервер для оценки безопасности и качества AI-агентов. Проверяет вывод на PII, инъекции, галлюцинации, контролирует стоимость. Логирует трассировки, имеет веб-дашборд. Работает с любым MCP-клиентом без SDK.

TypeScript⭐ 9
hyperb1iss/droidmind

hyperb1iss/droidmind

от hyperb1iss

DroidMind связывает AI-ассистентов с Android-устройствами через MCP. Управляйте приложениями, анализируйте логи, автоматизируйте UI и выполняйте shell-команды на естественном языке. Полезен разрабо...

Python⭐ 440
ios-simulator-mcp

ios-simulator-mcp

от joshuayoes

Управляет iOS-симулятором на Mac: тапает по экрану, вводит текст, свайпает, делает скриншоты и видео, устанавливает и запускает приложения.

JavaScript⭐ 2194
testdino-hq/testdino-mcp

testdino-hq/testdino-mcp

от testdino-hq

MCP сервер для интеграции TestDino с AI-агентами: запрашивайте результаты тестов, анализируйте ошибки, управляйте тест-кейсами и запусками простыми командами. Полезен QA-инженерам для ускорения работы с тестовыми данными.

TypeScript⭐ 9
qainsights/locust-mcp-server

qainsights/locust-mcp-server

от qainsights

MCP-сервер для запуска нагрузочных тестов Locust из AI-сред. Просто интегрирует написание тестовых сценариев и запуск в headless или UI режиме. Полезен разработчикам и QA для быстрой верификации пр...

Python⭐ 13
browserstack/mcp-server

browserstack/mcp-server

от browserstack

MCP сервер BrowserStack для тестирования через AI. Управляйте тест-кейсами, запускайте ручные и автотесты, отлаживайте и исправляйте код на естественном языке. Работает в Cursor и Claude.

TypeScript⭐ 155
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин