text-adventure-mcp

A minimal MCP server that lets an agent converse with a line-oriented text service over TCP: a Zork-style game, a telnet MUD, or any automation that exposes a text command interface.

The server is a dumb pipe. It holds the socket, terminates lines, strips escape codes, and hands back whatever the service said. All interpretation of the text stays with the agent.

The connection is stateful, so the server keeps one socket open per address across tool calls.

Tool

One tool, text_adventure:

Failed calls are reported as MCP tool errors. The MCP SDK puts Error executing tool text_adventure: in front of the message, so the status lines and any partial text follow that prefix.

Safety

This is an arbitrary outbound TCP client and can reach anything the host can reach, including internal services. That is the point. Do not expose it to untrusted callers, and do not point it at services you are not authorized to use.

The connection is raw TCP. The server does no telnet negotiation (no IAC DO/WILL/WONT/DONT replies) and strips no IAC bytes. Telnet bytes from the service reach the caller as replacement characters. Only ANSI escape sequences are removed from the text.

Install and run

Requires Python 3.11 or newer.

Straight from PyPI (stdio transport; blocks waiting for a client):

uvx text-adventure-mcp

Or point an MCP client at it:

{
  "servers": {
    "text-adventure": {
      "type": "stdio",
      "command": "uvx",
      "args": ["text-adventure-mcp"]
    }
  }
}

Develop

uv venv .venv --python 3.12
uv pip install -e ".[dev]"
.venv/Scripts/text-adventure-mcp.exe      # stdio transport; blocks waiting for a client

Tests

.venv/Scripts/python.exe -m pytest

Naming note

The design notes call the SDK class FastMCP. In the official mcp 2.x package that class is named MCPServer (from mcp.server.mcpserver import MCPServer). This project depends on mcp>=2,<3 and uses MCPServer. The mcp.server.fastmcp module from 1.x is not present in 2.x.