Repository avatar
Other Tools
v1.0.0
active

injection-process

io.github.DreamwayChan/injection-process

Injection molding first-shot recommendation and defect-driven tuning API.

Documentation

AICraft MCP Server

License: MIT

A Model Context Protocol server that gives AI agents access to injection molding process optimization: first-shot process recommendation and defect-driven tuning.

This is a thin MCP client. All calculation, authentication, and billing happen on the hosted HTTPS API. No process data or algorithm code runs locally.

What it does

Injection molding engineers need two things: a sensible starting set of machine parameters before a trial run, and corrections when the trial shows defects. This server exposes both as MCP tools, backed by a self-developed rule engine with explainable reasoning.

ToolWhat it doesCost
schemaFree catalog of fields, units, defect codes, and error codesFree
first_shotRecommend initial process parameters from material, part, and machine data1 API call
optimizeAdjust current parameters for an observed defect1 API call

The paid tools require a subscription API key. Get one at https://aicraft4injection.com ($19/month, 1000 calls). The schema tool works without a key so agents can discover the contract before paying.

Requirements

Installation

pip install -r requirements.txt

Configuration

Set two environment variables:

export AICRAFT_API_KEY="sk_your_key_here"                       # required for paid tools
export AICRAFT_BASE_URL="https://aicraft4injection.com"         # optional, this is the default

Usage with MCP clients

Add this server to your MCP client configuration (Claude Desktop, Cursor, Cline, etc.):

{
  "mcpServers": {
    "aicraft": {
      "command": "python",
      "args": ["/absolute/path/to/agent-mcp-server/server.py"],
      "env": {
        "AICRAFT_API_KEY": "sk_your_key_here",
        "AICRAFT_BASE_URL": "https://aicraft4injection.com"
      }
    }
  }
}

Restart the client. Three tools should appear: schema, first_shot, optimize.

Tool reference

schema

No arguments. Returns field groups, default units (mm, mm/s, MPa, rpm, °C, s), valid defect codes, and error codes.

first_shot

Requires three fields (the engine cannot compute without them):

FieldMeaning
polymer.polymer_abbreviationMaterial short name, e.g. PC, ABS
mold.product_ave_thicknessAverage wall thickness in mm (0 < value < 50)
machine.injector.injector_screw_diameter_mmScrew diameter in mm (> 0)

Recommended but optional: melt density, back pressure, drying temperature, gate thickness, clamp force, injection stroke, barrel temperature zones.

Example argument:

{
  "polymer": {"polymer_abbreviation": "PC", "melt_density": 1.05},
  "mold": {"product_ave_thickness": 2.0, "gate_thickness": 1.2},
  "machine": {"machine_clamp_force_ton": 180,
              "injector": {"injector_screw_diameter_mm": 36}}
}

optimize

Requires a defect and the current process parameters:

{
  "defect_info": [{"desc": "FLASH", "level": "moderate"}],
  "current_params": {"IP0": 90, "IV0": 40, "PP0": 50, "CT": 12}
}

desc accepts stable codes such as SHORTSHOT, FLASH, SHRINKAGE, BURN, WELDLINE, WARPING (25 codes in total — call schema for the full list).

level accepts an English enum or a number from 0 to 1 (no Chinese values):

ValueMeaning
noneNo defect — the row is dropped
mildMinor defect
moderateMedium defect
severeSerious defect
criticalVery serious defect

The gateway translates these to the engine's internal severity values. Invalid levels are rejected with 400 INVALID_FIELD and do not consume quota.

Understanding the result

A successful call returns three layers, so you never have to guess what a code like IP0 means:

  1. summary — a one-paragraph, human-readable sentence. Read this aloud to the user.
  2. parameters — one entry per process value with key, name (full English name), value, unit, and group. Use name when explaining a value.
  3. data — the raw key -> value map, intended for writing settings back to a machine. Keys are abbreviations; humans should use summary or parameters instead.

Example parameters entry:

{"key": "NT", "name": "Nozzle temperature", "value": 280, "unit": "C", "group": "temperature"}

Common key groups (full dictionary for every key is available from the free schema tool under parameters):

PrefixMeaning
NT, BT1..BT4Nozzle temperature, barrel temperature zones
IP0..IP5Injection pressure, stage 0..5
IV0..IV5Injection velocity, stage 0..5
IL0..IL5Injection stroke end position, stage 0..5
PP0..PP4, PV0..PV4, PT0..PT4Holding pressure / velocity / time
MP0..MP3, MSR0..MSR3, MBP0..MBP3, ML0..ML3Metering pressure / screw speed / back pressure / position
VPTL, VPTT, VPTP, VPTVV/P switch position, time, pressure, velocity
CT, IT, ID, MD, MELCooling time, injection time/delay, metering delay/end
DPBM..DTBM, DPAM..DTAMDecompression before / after metering (pressure, velocity, distance, time)

Default units: mm, mm/s, MPa, rpm, °C, s. A request can override them with pressure_unit, velocity_unit, position_unit, and screw_rotation_unit.

Design notes

  • Stdio transport, protocol version 2024-11-05 for broad client compatibility.
  • No local computation. The server forwards JSON-RPC tool calls to the hosted API; the engine stays on the operator's own infrastructure.
  • Stable error codes. Every API response carries an api_version and a machine-readable code (e.g. MISSING_FIELD, UNKNOWN_DEFECT, QUOTA_EXCEEDED, ENGINE_REJECTED). Agents branch on code, not on prose.
  • No charge on invalid input. Requests rejected by validation do not consume quota. Engine failures are refunded automatically.

A Streamable HTTP endpoint is also available for clients that prefer remote MCP: https://aicraft4injection.com/mcp (discovery document at /.well-known/mcp.json).

Links

License

MIT

No installation packages available.