Skip to main content
Glama
negative-support-mcp

negative-support-mcp

by spikeon

@spikeonstudio/negative-support-mcp

MCP server for negative.support — generate negative-space print supports (STL/OBJ/STEP) via the official negative-support package. Full API details: negative.support/docs.

Requirements

  • Node.js 18+

  • A negative.support token (ns_live_…) from negative.support after sign-in

For a local clone, you can put NEGATIVE_SUPPORT_TOKEN=… in a .env file next to package.json (see .env.example). The server loads it via dotenv when the process working directory is that folder. Do not commit .env — it is listed in .gitignore.

Related MCP server: Pixal3D-MCP

MCP configuration

Use npx — no clone or local npm install required. Set NEGATIVE_SUPPORT_TOKEN, or omit it and call negative_support_activate once per session.

npx normally runs with another cwd, so prefer env in the MCP JSON for Cursor; use .env when you run npm run dev / npm start from this repo.

npm (default)

{
  "mcpServers": {
    "negative-support": {
      "command": "npx",
      "args": ["-y", "@spikeonstudio/negative-support-mcp"],
      "env": {
        "NEGATIVE_SUPPORT_TOKEN": "ns_live_..."
      }
    }
  }
}

From GitHub (same binary name as in package.json bin):

{
  "mcpServers": {
    "negative-support": {
      "command": "npx",
      "args": ["-y", "--package=github:spikeon/negative-support-mcp", "negative-support-mcp"],
      "env": {
        "NEGATIVE_SUPPORT_TOKEN": "ns_live_..."
      }
    }
  }
}

On Windows, if npx is missing, use "command": "npx.cmd" with the same args.

Tools

Tool

Description

negative_support_activate

Activate your license for this process.

negative_support_deactivate

Clear the local session (token not revoked on the server).

negative_support_generate

Build supports from a local STL/OBJ/STEP/STP; writes *_supports.stl and optional .3mf.

negative_support_generate: input_path (absolute, on the host running the MCP) is required. Optional: output_stl_path, output_3mf_path, format, margin, angle, min_volume, skip_merge — see negative.support/docs.

Resource: negative-support://docs — short in-server summary.

Timeouts

Generation can take several minutes on large meshes. Many MCP clients use a default tool timeout (often around 60s) unless the call stays “active.” This server emits MCP notifications/progress when the client sends a progressToken with the tool request (about every 15s plus throttled updates from the library), which usually refreshes that timeout.

If a host still cuts you off, use the negative-support CLI for huge models, or raise the tool-timeout in your client if it exposes one.

Development

git clone https://github.com/spikeon/negative-support-mcp.git
cd negative-support-mcp
npm install
npm run build   # or: npm run dev

The server uses stdio; it is started by the MCP host, not run interactively.

Publishing (maintainers)

Pushing to main does not publish. .github/workflows/publish-npm.yml runs npm publish --access public when a v* tag is pushed.

  1. Add repository secret NPM_TOKEN (npm access token with publish rights for @spikeonstudio/*).

  2. Bump version in package.json (each publish must be a new version).

  3. git tag vX.Y.Z && git push origin vX.Y.Z

prepublishOnly runs npm run build. dist/ is committed so GitHub-based npx installs work without a local TypeScript build.

License

MIT. Not affiliated with negative.support; integrates their published npm package and licensing.

Available Tools

3 tools
negative_support_activateA

Activate a negative.support license for this MCP process. Same ns_live_* token as the CLI. Alternatively set env NEGATIVE_SUPPORT_TOKEN.

Inputs: token (required). Returns: ok, message

negative_support_deactivateA

Clear the active license in this process (does not revoke the token on the server).

Inputs: no named parameters. Returns: ok, message

negative_support_generateA

Generate support STL (and optionally 3MF with model + support pieces) from a local STL, OBJ, STEP, or STP file. Requires an activated license. Heavy meshes can take many minutes; MCP hosts that send a progressToken receive keepalive progress and avoid tool timeouts.

Inputs: input_path (required), angle, format, margin, +4 more. Returns: stats, progress, output_3mf_path, output_stl_path

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct operation: activation, deactivation, and generation. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    All tool names follow the same pattern: 'negative_support_' prefix plus a clear verb (activate, deactivate, generate). The convention is consistent and predictable.

    Tool Count5/5

    With 3 tools, the set is tightly scoped to the server's purpose of license management and STL generation. Each tool earns its place with no redundancy.

    Completeness5/5

    The core lifecycle is covered: activate a license, deactivate it, and generate output. No obvious missing operations for the stated domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers