Just published Signalk MCP Server
Just published Signalk MCP Server updates.
Primary changes are the use of code execution over tool calls with json response payloads. Agents are very good at writing code, so adding map, reduce, sort, filter...basically any native JavaScript function to generate the data it needs for generating context from Signalk.
If you already have the Signalk MCP server installed, I highly recommend upgrading to the latest version for massive performance improvements.
https://www.npmjs.com/package/signalk-mcp-server
12 Replies
Hi Tony, thanks for sharing. I am interested to try it.
npx wants to install 1.0.6,
do you recommend to install folowing the dev instructions?
1.0.6 is the correct version and yes the instructions should be correct. npx allows auto install so you dont have to clone the repository. Only caveat would be if you use a node version manager
Ok, got confused as on github it's all about 2.x and migration from 1.x
so 1.0.6 on npmjs = 2.0.0 in changelog?
Correct. I will fix that confusion right now
After executing I get this:
dirk@pi5:~ $ npx signalk-mcp-server
Need to install the following packages:
signalk-mcp-server@1.0.6
Ok to proceed? (y) y
[CODE MODE] Code execution enabled
signalk-mcp-server v1.0.0 running on stdio
Failed to load resource signalk-overview.json: ENOENT: no such file or directory , open '/home/dirk/.npm/_npx/895df29ef233bb7f/node_modules/signalk-mcp-server/re sources/signalk-overview.json'
Failed to load resource data-model-reference.json: ENOENT: no such file or direc tory, open '/home/dirk/.npm/_npx/895df29ef233bb7f/node_modules/signalk-mcp-serve r/resources/data-model-reference.json'
Failed to load resource path-categories-guide.json: ENOENT: no such file or dire ctory, open '/home/dirk/.npm/_npx/895df29ef233bb7f/node_modules/signalk-mcp-serv er/resources/path-categories-guide.json'
Failed to load resource mcp-tool-reference.json: ENOENT: no such file or directo ry, open '/home/dirk/.npm/_npx/895df29ef233bb7f/node_modules/signalk-mcp-server/ resources/mcp-tool-reference.json'
SignalK HTTP connection verified
SignalK client connected successfully
So I assume it is started correctly, is there any http request or url I can call to see if it is online?Are the Environment Variables mandatory?
I mean:
EXECUTION_MODE=code
it is not in the sample.
The problem was that "Claude" was still in taskbar (background) and only reads the config after killing it with taskmanager.
Seems like package was build correctly, but I have a error messages in
mcp-server-signalk.log of claude logs.
2025-11-23T19:39:04.030Z [signalk] [info] Server started and connected successfully { metadata: undefined }
2025-11-23T19:39:04.069Z [signalk] [info] Message from client: {"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0} { metadata: undefined }
....some cleanup warnings and at the end:
2025-11-23T19:39:25.197Z [signalk] [info] Server transport closed { metadata: undefined }
2025-11-23T19:39:25.197Z [signalk] [info] Client transport closed { metadata: undefined }
2025-11-23T19:39:25.198Z [signalk] [info] Server transport closed unexpectedly, this is likely due to the process exiting early. If you are developing this MCP server you can add output to stderr (i.e. console.error('...') in JavaScript, print('...', file=sys.stderr) in python) and it will appear in this log. { metadata: undefined }
2025-11-23T19:39:25.198Z [signalk] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) { metadata: { context: 'connection', stack: undefined } }
2025-11-23T19:39:25.199Z [signalk] [info] Client transport closed { metadata: undefined }
If you have ai it can figure it out for you
It also needs to authenticate with the server so maybe you need to allow with admin role
thanks for helping, yes, SK Server has auth enabled. Do I need additional Env variables?
No you have the right env vars
i think i have it now.
https://github.com/tonybentley/signalk-mcp-server/pull/5