nodrix — Claude Code MCP server: what it does, how to install
Connects your self-hosted Cloudflare IoT backend to an AI assistant. Lets you monitor live hardware metrics and trigger switches remotely.
Open on GitHubWhat nodrix does
The nodrix MCP server links an assistant directly to an IoT backend running on your Cloudflare Workers setup. Hardware does not need a local USB tether to your laptop. Microcontrollers stream values over WebSockets or HTTPS, letting the LLM inspect current metrics from anywhere.
Inside, the server exposes 12 read tools and 16 write tools. The assistant can fetch historical telemetry series, read device states, or command connected hardware with set_variable. Deletion tools are omitted entirely to prevent accidental wiping of project dashboards or variables.
External access stays disabled out of the box. Until the owner turns on mcp_enabled in the administration panel, the /v1/mcp route replies with a 404 status. Hardware actuation remains locked until you also enable mcp_write_enabled.
What it helps with
- inspect live metrics reported by remote ESP32 or Arduino boards
- toggle relays and update output variables via
set_variable - retrieve time-series data partitions for analysis
- trigger configured automations and run integration tests
Example prompts for the agent
- Fetch the latest temperature and humidity metrics for project
workshop - Use
set_variableto switch the cooling relay to active - List all configured automations and check which triggers fired
How to install nodrix
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http nodrix https://{host}/v1/mcp/oauth1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add nodrix --url https://{host}/v1/mcp/oauth1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"nodrix": {
"url": "https://{host}/v1/mcp/oauth"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"nodrix": {
"type": "http",
"url": "https://{host}/v1/mcp/oauth"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http nodrix https://{host}/v1/mcp/oauthStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about nodrix
How do I install nodrix in Claude Code?
Run claude mcp add --transport http nodrix https://{host}/v1/mcp/oauth in your terminal. Replace {host} with your deployed Cloudflare Worker domain.
What does the nodrix MCP server do?
It gives AI assistants direct access to telemetry streams and hardware actuators through your personal cloud deployment.
Why does the /v1/mcp endpoint return a 404 error?
The MCP server is disabled initially. The account owner must navigate to **Settings → More** in the dashboard and toggle mcp_enabled.
