
spinspec
io.github.CloudCorpRecords/spinspec
Centrifuge specs, stock and RCF sizing for remanufactured Alfa Laval centrifuges.
Documentation
spinspec
Finding the right remanufactured centrifuge starts with trustworthy numbers. spinspec is a local forwarding client for the Dolphin Centrifuge MCP service: it can pull published specifications for an Alfa Laval disc stack or decanter machine, list the models Dolphin publishes, check which units are currently in stock at Warren, Michigan, and run the RCF/RPM sizing calculation that ties bowl diameter, speed and g-force together.
No catalogue lives in this package. tools/list is answered locally from a captured definition set, and every tools/call is forwarded upstream over a streamable-HTTP JSON-RPC session, with the result returned exactly as the service sent it.
This is a labelled subset rebuild. The capture enumerates five tools and four are built here. request_quote is omitted: its captured description says it sends the user's real name, company and email to the vendor's sales team, so it is not registered, not listed, and not available from the CLI.
The tools
get_centrifuge_specs— Published specifications for a remanufactured Alfa Laval disc stack or decanter centrifuge, or a Dolphin DMPX/DMB module. Pass an exactmodelsuch as "MOPX 207", or a free-textquerywhen the model is unknown.list_centrifuge_models— The models Dolphin publishes specs for, optionally filtered bytype("disc stack" or "decanter") and by anapplicationkeyword.check_dolphin_stock— A dated stock list, optionally filtered bymodelor family. No prices or serial numbers.size_centrifuge— RCF sizing using RCF = 1.118e-5 x r(cm) x RPM^2. Give any two ofbowl_diameter_m,rpmandg_forceand get the third, plus separation guidance.
None of the four tools requires any argument; every field is optional in the captured schemas, and no required key has been added.
Install and run
npx -y @reneturcios/spinspec mcp
MCP client configuration:
{
"mcpServers": {
"spinspec": {
"command": "npx",
"args": ["-y", "@reneturcios/spinspec", "mcp"]
}
}
}
Container:
docker run -i ghcr.io/cloudcorprecords/spinspec
docker run --rm ghcr.io/cloudcorprecords/spinspec size_centrifuge '{"rpm":8000,"bowl_diameter_m":0.36}'
CLI
spinspec get_centrifuge_specs '{"model":"MOPX 207"}'
spinspec list_centrifuge_models '{"type":"disc stack"}'
spinspec check_dolphin_stock '{}'
spinspec size_centrifuge '{"rpm":8000,"bowl_diameter_m":0.36}'
spinspec --version
Exit codes: 0 on success, 1 when the forwarded result is an error, 2 for usage errors such as an unknown subcommand or malformed JSON.
Configuration
DOLPHINCENTRIFUGE_MCP_URL— Overrides the upstream endpoint, which otherwise defaults tohttps://dolphincentrifuge.com/mcp. (This override is a reconstruction added by the rebuild.)
No authentication header is ever sent. The registry record declares no headers for this remote and the tool surface was captured without a key.
Failures from upstream — a JSON-RPC error, a non-2xx status, an unreadable body, or a failed request — surface as an error result whose text begins with spinspec error:.
How forwarding works
The first call opens a session with an initialize request (protocol version 2025-03-26), followed by notifications/initialized, then the tools/call. An Mcp-Session-Id header issued by the service is carried on later requests and the session is reused for the life of the process. Replies may be plain JSON or server-sent events. Successful results pass through verbatim, including any isError flag and extra fields.
Development
npm install
npm run build
npm test
npm run dev
Tests run against a stubbed JSON-RPC upstream with no live network. They check the served list against the captured fixture, assert request_quote is absent at registry, MCP and CLI levels, and cover session handling, the env override, the no-auth-header guarantee, verbatim forwarding, result pass-through including upstream errors, SSE parsing, and error rendering.
License
MIT — see LICENSE. Copyright (c) 2026 Rene Turcios.
@reneturcios/spinspecnpm install @reneturcios/spinspecghcr.io/cloudcorprecords/spinspec:0.1.0docker pull ghcr.io/cloudcorprecords/spinspec:0.1.0:undefinedRelated Servers
io.github.CloudCorpRecords/abandoncheck
Judge whether a dependency is maintained, from factual signals: releases, commits, archival.
io.github.CloudCorpRecords/actionbridge
Zapier exposed actions as MCP tools via a generic action runner.
io.github.CloudCorpRecords/actionpin
GitHub Actions supply-chain hardener: audit workflows for unpinned actions and build a SHA pin plan.