aevella/sky-pc-mcp-companion

This is a small local tool for the PC version of Sky: Children of the Light, a social exploration game. It wraps four basic computer interactions: taking a screenshot of the game window, reading text from that screenshot using OCR (a technique that converts an image of text into actual readable text), sending keyboard key presses to the game, and pasting chat messages into the game's chat box. These four actions are exposed as tools over a protocol called MCP, which is a standard way that AI assistants and agents communicate with external tools. The README and documentation are written in Chinese. The intended use is local experimentation, such as connecting an AI chat assistant to the game so it can see what is on screen and respond as a companion. For example, an AI model on a phone or another device on the same local network could call these tools to read the game screen, interpret the content, and send a chat reply. The server runs on the Windows PC where the game is installed and accepts connections only from devices on the same local network. The tool can run in two modes: an HTTP server mode that listens on port 9800 and requires a token for access, and a stdio mode for AI clients that support direct process communication. For text recognition, it uses a library called PaddleOCR, which downloads its model files the first time it runs. Keyboard input uses either PyDirectInput or PyAutoGUI, and if the game was launched with administrator privileges, the tool also needs to be run as administrator for key presses to reach the game window. The README explicitly states what the tool does not do: it does not read game memory, modify the game client, reverse-engineer network traffic, or provide farming, auto-play, or botting features. The author asks users not to expose the server to the public internet, not to share the access token, and to stop using the tool if the game's terms of service prohibit automation. Requirements are Windows and Python 3.10 or later.