Switch MCP-Server

Switch MCP-Server
General
Author	FitzQ
Type	Utilities
Version	1.0.0
License	N/A
Last Updated	2025/08/07
Links
Download
Website
Source

An MCP Server for the Nintendo Switch, it offers:

• tools
  • Controller input injection (support button presses, joystick movements, six-axis motion controls, etc).
  • Screen capture.
• resources
• prompts

Installation

Copy the entire contents of the out/atmosphere/contents/010000000000B1C0 folder to the /atmosphere/contents/ directory on your Switch's SD card.

Navigate to Hekate Toolbox > Background Services > mcp-server and enable it.

Configuration:

{
  "servers": {
    "switch-mcp-server": {
      "type": "streamableHttp",
      "url": "http://{your switch ip}:12345/mcp"
    }
  }
}

Known issues

Occasionally, the service may fail to start due to memory allocation issues (requires about 2MB of heap memory). Restarting the console usually resolves this. If the allocated memory is too small, screen image retrieval may not function correctly

Changelog

v1.0

• First Release.

Credits

• devkitPro
• libnx
• stb_base64

External links

• GitHub - https://github.com/FitzQ/mcp-server
• ForTheUsers - https://hb-app.store/switch/mcpserver