Switch MCP-Server
More actions
| Switch MCP-Server | |
|---|---|
 | |
| General | |
| Author | FitzQ |
| Type | Utilities |
| Version | 1.0.0 |
| License | N/A |
| Last Updated | 2025/08/07 |
| Links | |
| Download | |
| Website | |
| Source | |
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.
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.
Features
- 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:
{
"servers": {
"switch-mcp-server": {
"type": "streamableHttp",
"url": "http://{your switch ip}:12345/mcp"
}
}
}
Changelog
v1.0
- First Release.
External links
- Github - https://github.com/FitzQ/mcp-server
- HB-App - https://hb-app.store/switch/mcpserver