the-nexus/mcp_servers

MCP Servers for Bannerlord Harness

This directory contains MCP (Model Context Protocol) servers that provide tools for desktop control and Steam integration.

Overview

MCP servers use stdio JSON-RPC for communication:

• Read requests from stdin (line-delimited JSON)
• Write responses to stdout (line-delimited JSON)
• Each request has: jsonrpc, id, method, params
• Each response has: jsonrpc, id, result or error

Servers

Desktop Control Server (desktop_control_server.py)

Provides desktop automation capabilities using pyautogui.

Tools:

• take_screenshot(path) - Capture screen and save to path
• get_screen_size() - Return screen dimensions
• get_mouse_position() - Return current mouse coordinates
• pixel_color(x, y) - Get RGB color at coordinate
• click(x, y) - Left click at position
• right_click(x, y) - Right click at position
• move_to(x, y) - Move mouse to position
• drag_to(x, y, duration) - Drag with duration
• type_text(text) - Type string
• press_key(key) - Press single key
• hotkey(keys) - Press key combo (space-separated)
• scroll(amount) - Scroll wheel
• get_os() - Return OS info

Note: In headless environments, pyautogui features requiring a display will return errors.

Steam Info Server (steam_info_server.py)

Provides Steam Web API integration for game data.

Tools:

• steam_recently_played(user_id, count) - Recent games for user
• steam_player_achievements(user_id, app_id) - Achievement data
• steam_user_stats(user_id, app_id) - Game stats
• steam_current_players(app_id) - Online count
• steam_news(app_id, count) - Game news
• steam_app_details(app_id) - App details

Configuration: Set STEAM_API_KEY environment variable to use live Steam API. Without a key, the server runs in mock mode with sample data.

Configuration

The mcp_config.json in the repository root configures the servers for MCP clients:

{
  "mcpServers": {
    "desktop-control": {
      "command": "python3",
      "args": ["mcp_servers/desktop_control_server.py"]
    },
    "steam-info": {
      "command": "python3",
      "args": ["mcp_servers/steam_info_server.py"]
    }
  }
}

Testing

Run the test script to verify both servers:

python3 mcp_servers/test_servers.py

Or test manually:

# Test desktop control server
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | python3 mcp_servers/desktop_control_server.py

# Test Steam info server  
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | python3 mcp_servers/steam_info_server.py

Bannerlord Integration

These servers can be used to:

• Capture screenshots of the game
• Read game UI elements via pixel color
• Track Bannerlord playtime and achievements via Steam
• Automate game interactions for testing