Anvil

io.github.The-Warl0ckPublished by GitHub account The-Warl0ckv0.1.2Updated Oct 24, 2026

Local physics/chemistry bench as MCP: plain words in, 12-domain simulations out.

Overview

AI-generated overview

Anvil is a local MCP workbench that turns plain-language engineering requests into 12-domain physics and chemistry simulations, proof metrics and printable 3D/C

What you can do
List the 12 simulation domains and what each one models, such as silicon, mechanical, chemistry, optics and sky ephemeris. Forge a blueprint from a plain-language intent, with an optional domain, using local templates and numbers parsed from the request. Solve a blueprint with the domain solver and return a deterministic snapshot plus proof metrics with tolerances and pass/warn statuses. Export blueprint geometry as ASCII STL or OBJ text for 3D printing or CAD.
When to use it
Useful when an assistant needs to draft and sanity-check an engineering or science design locally, for example a circuit, mechanical part, alloy or optical layout, and produce a printable mesh with supporting numbers before anything is fabricated.
Requirements
Runs as a local stdio process on the user's machine, launched with npx or from a cloned repository. Requires Node.js 20 or newer. No API key, account or network access is needed. An optional ANVIL_HOME environment variable sets where saved designs and exports live.
Before you install
The tools write files to the local ANVIL_HOME directory (default ~/.anvil), so exports and saved designs land on disk. Results are template-based simulations with proof metrics, not validated engineering analysis; treat them as a starting point before printing or building anything.

Installation

In SourceWeft

  1. Open Anvil in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

anvil-mcp

Anvil — a full workbench for your agent.

No cloud. No Bridge. No API key. No LLM inside — the tools are pure computation; your agent host brings the thinking.

Plain words in — your agent forges the design, tests it against proof metrics, iterates until it passes, and hands you the file. You never touch a tool.

30 seconds

you:    "I need a 5-stage CMOS ring oscillator at 7nm — prove it works         before I print anything."
agent:  anvil.forge  → blueprint: silicon · 8 nodes · "5-stage ring at 7 nm, VDD 0.75 V."        anvil.solve  → [pass] Joule power · [pass] junction temp · [warn] EM margin thin        anvil.forge  → widens the vias, re-forges        anvil.solve  → all metrics pass        anvil.export → 532 triangles of ASCII STL
you get: the printable file, plus the proof it works.

Install

Requires Node ≥ 20. No build step needed for use:

sh
npx github:The-Warl0ck/anvil-mcp

Or clone and run:

sh
git clone https://github.com/The-Warl0ck/anvil-mcpcd anvil-mcpnpm installnpm run buildnpm start

Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "anvil": {      "command": "npx",      "args": ["github:The-Warl0ck/anvil-mcp"]    }  }}

Tools

ToolInputOutput
anvil.domains{}The 12 domains and what each simulates
anvil.forge{ intent, domain? }Blueprint JSON + rationale (offline — no LLM in the tool itself)
anvil.solve{ blueprint, steps? }SimSnapshot + ProofMetric[] with real numbers
anvil.export{ blueprint, format }STL (ASCII) or OBJ text for 3D printing / CAD

The 12 domains

silicon (nets, delay, heat, electromigration) · cellular (membranes, ions, morphogens) · quantum (wells, tunneling, decoherence) · neural (spikes, region flows) · mechanical (stress, modes, yield) · chemistry (mass-action kinetics, ΔH, equilibrium) · architecture (plans, interiors, circulation) · metallurgy (alloys, CE, melt, print window) · robotics (arms, torque, reach, payload) · machines (engines, gears, printable parts) · optics (geometry, gnomon, shadows, sundials) · sky (sun position / ephemeris)

How it works

  1. anvil.forge — readIntent scores your words against per-domain keyword sets, picks a domain, and forgeOffline builds a schematic graph (nodes, edges, physical params) from templates plus your numbers (e.g. "7nm", "5-stage", "0.75 V"). Pure local compute.
  2. anvil.solve — createSolver dispatches to the domain solver (Kirchhoff MNA for silicon, Euler–Bernoulli for mechanical, mass-action for chemistry, …), steps it, and returns a snapshot plus proof metrics — checks with real tolerances and statuses.
  3. anvil.export — blueprint geometry meshed to ASCII STL or OBJ text.

Everything runs in-process. There is no network call anywhere in the default path.

Config

Optional — nothing is required to run:

sh
ANVIL_HOME=~/.anvil   # where saved designs / assets / exports live (default ~/.anvil)

Notes

  • Any OpenAI-compatible "mouth" (LM Studio, etc.) is a future opt-in, not part of v1. The kernel speaks blueprints, not prose, and that's the point.
  • anvil.solve returns a deterministic snapshot after N steps of the solver's recommended dt — no wall-clock randomness.
  • Apache-2.0. See LICENSE.

Source: README.md at commit 83e8e83

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 26, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts