kenshi-link
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
kenshi-mcp
An MCP server that lets Claude play Kenshi. Claude sees the game through screenshots and operates it with the mouse and keyboard, the way a person would. It works with Claude Code and Claude Desktop, and includes a runner for unattended play through the Claude API.
The Python package and its command are called kenshi-link.
Status
Early. It was built and tested on a machine without the game:
The controller, the MCP server and the unattended runner are covered by tests against a stand-in window and a scripted API.
The whole test suite and the Windows self-test pass on Windows Python under Wine, including the MCP server and the runner driving a real Win32 window. The Linux/X11 code is tested against a real X server.
It has not yet been run against Kenshi itself, on native Windows, or against the live Claude API.
Key bindings come from the game's published defaults. How Kenshi handles input (its action menu, pausing, edge scrolling, Escape) is taken from the wiki and from a third-party analysis of the game, and the stand-in window was made to behave the same way. None of that has been checked against the game. Expect the first real session to turn up things that need tuning. Reports of what breaks are welcome.
Related MCP server: Win:Computer Use
How it works
Kenshi is real-time with pause, and Claude needs several seconds per decision. So game time is something Claude spends on purpose:
The game stays paused while Claude looks and gives orders. Kenshi accepts orders while paused.
advance(seconds, speed)runs the clock for a set time, pauses again, and returns a strip of in-between frames plus the final screenshot.Every action returns a screenshot taken afterwards, with a ring where a click landed, so Claude can check its own aim.
Kenshi also pauses and un-pauses by itself (a conversation, the build window, loading). The tool pauses with a key sequence meant to end paused whatever the game was doing, and tells Claude when the picture contradicts what it expects.
Claude works from screenshots only. It cannot read game memory or save files, so numbers come from zooming in on the UI, and fast combat micro-management is out of reach.
Setup (Windows)
You need Kenshi set to windowed or borderless (exclusive fullscreen gives black screenshots), Python 3.11 or newer, and Claude Code, Claude Desktop or a Claude API key.
In PowerShell:
git clone https://github.com/GearUnclear/kenshi-mcp
cd kenshi-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[agent]"Leave out [agent] if you only want the MCP server. If PowerShell refuses to run
Activate.ps1, run Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
once and try again.
Start Kenshi, load a save, and check that the window is found and captured:
kenshi-link doctor --screenshot check.jpgOpen check.jpg. It should show the game. A black picture means exclusive fullscreen.
To check input injection and capture without the game, run the self-test. It opens a small test window and verifies that every kind of input arrives intact; leave the mouse and keyboard alone while it runs.
python tests\windows_selftest.pyRun everything at the same privilege level as the game. If Kenshi runs as administrator and this does not, Windows silently drops the input.
Connect a Claude client
Claude Code, from the kenshi-mcp folder:
claude mcp add --scope user kenshi -- "$PWD\.venv\Scripts\kenshi-link.exe" serveClaude Desktop: add this to %APPDATA%\Claude\claude_desktop_config.json with your own path
(backslashes doubled), then restart the app.
{
"mcpServers": {
"kenshi": {
"command": "C:\\Users\\you\\kenshi-mcp\\.venv\\Scripts\\kenshi-link.exe",
"args": ["serve"]
}
}
}Then, with a save loaded, ask Claude to play. For example: "Use the kenshi tools. My character is in the Hub with almost no money. Earn 1,000 cats by mining copper and selling it, and keep them alive."
Claude uses your real mouse and keyboard, and brings Kenshi to the front whenever it acts, so leave the PC to it while it plays.
Unattended play
$env:ANTHROPIC_API_KEY = "sk-ant-..."
kenshi-link play --goal "Mine copper near the Hub and sell it until we have 1,000 cats." --max-steps 40This runs Claude in a loop through the Claude API until the goal is reached or the budget
runs out (by default 300 game actions or 120 minutes, on claude-opus-5-5). Every turn sends
a screenshot, so long sessions cost real money. Start small.
If a safety classifier declines a turn, the API retries it on a fallback model instead of ending the session.
--no-fallbacksturns that off.Old screenshots are cleared from the context server-side. If a conversation still grows very large, Claude writes a handoff into its notes file and a fresh conversation continues from it.
See kenshi-link play --help for the other options. Transcripts are written to
%USERPROFILE%\.kenshi-link\sessions\.
Stopping it
Any of these disables all input until you allow it again:
Push the mouse into the top-left corner of the screen (the leftmost one, if you have several).
Run
kenshi-link stopfrom another PowerShell window.Tap Pause/Break, if your keyboard has it.
A stop takes effect within moments, including in the middle of typing, a drag, a held key or
an open action menu. kenshi-link resume allows input again.
Other guard rails:
Input is only sent while the Kenshi window has focus, and pointer positions are confined to the window.
A click is refused where another window, such as a notification, covers the game.
Key combinations that leave the game (the Windows key, Alt+Tab, Alt+F4, Shift+Tab for the Steam overlay and similar) are refused, as are Kenshi's debug shortcuts.
Escape is only sent when Claude states that a game is loaded: on the title screen it quits Kenshi without asking.
The right button, held while the action menu is open, is released by any other action, a stop, shutdown, or 30 seconds without a choice.
The pointer is not left resting on the edge of the window, where it scrolls the camera.
If Kenshi is running as administrator and this is not, it says so instead of failing silently.
Tools
Tool | What it does |
| Screenshot, optionally with a coordinate grid |
| Enlarges a region at full resolution, for reading small text |
| Pointer input in screenshot coordinates |
| Kenshi's action menu, which shows only while the right button is held: hold it and see the menu in a screenshot, then release over an entry or cancel |
| Keyboard input, limited to keys that stay inside the game |
| Named actions through your key bindings: inventory, map, stats, research, build mode, squad selection, quick save and load |
| Pan, rotate, zoom and tilt |
| Run the game for N seconds at a chosen speed, then pause and report |
| Pause or run the clock; correct the tracked pause state |
| A notes file that persists between conversations |
| Search and browse the built-in reference on the game |
| A guide to Kenshi's controls and screen layout, read on demand |
Game reference
The package includes a reference on Kenshi for Claude to search instead of guessing: 16
Markdown files, about 850 short sections, in src/kenshi_link/knowledge/. They cover regions
and towns, factions, wildlife, law, recruits, races, stats, combat, health, game starts,
money-making, items, research and building, the interface, and step-by-step how-tos.
The facts come from the Kenshi wiki and from the documentation of the MeitouClient project, written in our own words. Each file lists its sources at the end, and a fact that could not be confirmed in a source is marked "(unverified)". The reference describes the unmodded game. Like the rest, it has not been checked against a running copy.
Configuration
Optional, in %USERPROFILE%\.kenshi-link\config.toml. config.example.toml lists every
setting. The one most likely to matter is [keymap]: if you have rebound keys in Kenshi,
mirror the changes there.
To try the tools without the game, set $env:KENSHI_LINK_BACKEND = "mock". That swaps Kenshi
for a built-in stand-in (numbered dots that can be selected, ordered around, paused and sped
up) and sends no real input.
Linux
Kenshi under Proton or Wine works through X11 or XWayland. Install the same way, and use
.venv/bin/kenshi-link in place of the .exe path. The data directory is ~/.kenshi-link.
Development
pip install -e ".[dev]"
pytestOn Linux, xvfb-run -a pytest -m x11 also runs the X11 backend tests against a real X server.
License
MIT. See LICENSE.
This is an unofficial project and is not affiliated with Lo-Fi Games. It automates the mouse and keyboard of a copy of Kenshi you own; it does not modify the game.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted Screenshots MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted YouTube MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceAn MCP server that lets Claude Desktop and Claude Code control your PC — take screenshots, click, type, manage windows, and more.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that gives Claude human-like control of a Windows PC with its own virtual cursor, an emergency stop, and a manager UI.1MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that lets Claude operate your real computer by moving the actual mouse, clicking, typing, and reading the actual screen, working with your own logged-in sessions in any application.83 PyPI1MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that gives Claude the ability to watch any desktop window, detecting changes and providing compact image bundles for Claude's vision, enabling real-time screen-watching without API costs.-