Switch MCP-Server: Difference between revisions

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

Newer edit →

Revision as of 14:18, 18 October 2025

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

External links

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

@@ Line 19: / Line 19: @@
 |image_alt=Switch MCP-Server
 }}
-Switch MCP-Server is a background service for the Nintendo Switch that allows external control and data retrieval via MCP (Message Control Protocol). It provides mechanisms for controller injection, screen frame capture, and prompting resources, making it useful for automation, debugging, or remote interaction purposes.
+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
-The server listens on port 12345 and can be activated through Hekate Toolbox → Background Services → mcp-server. Once running, clients can connect to it using a streamable HTTP configuration.
+== Installation ==
+Copy the entire contents of the <code>out/atmosphere/contents/010000000000B1C0</code> folder to the <code>/atmosphere/contents/</code> directory on your Switch's SD card.
-==Features==
+Navigate to Hekate Toolbox &gt; Background Services &gt; mcp-server and enable it.
-* Controller button injection, including buttons, joysticks, and six-axis control.
-* Capture and retrieve the current Nintendo Switch screen frame.
-* Provide prompt and resource management tools.
-* Compatible with remote client configuration for network interaction.
-==Notes==
-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
-==Configuration===
-Example client connection configuration:
+Configuration:
 <pre>
 {
@@ Line 47: / Line 42: @@
 }
 </pre>
+==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 ==
+* [https://devkitpro.org/ devkitPro]
+* [https://github.com/switchbrew/libnx libnx]
+* [https://github.com/nothings/stb stb_base64]
 == External links ==
-* Github - https://github.com/FitzQ/mcp-server
+* GitHub - https://github.com/FitzQ/mcp-server
-* HB-App - https://hb-app.store/switch/mcpserver
+* ForTheUsers - https://hb-app.store/switch/mcpserver