FieldCure.Mcp.ZStudio 0.14.0

ZStudio MCP Server

An MCP (Model Context Protocol) server that exposes the ZStudio electrochemical impedance spectroscopy (EIS) analysis engine to AI assistants. Import multi-vendor EIS measurement files, build and organize .zstudy documents, plot them, and run Z-HIT / Kramers–Kronig / DRT / equivalent-circuit fitting — directly from Claude, VS Code, and other MCP hosts.

ZStudio MCP ties ZStudio's validation / DRT / fitting engine into a conversational analysis flow, so you can check data quality faster, compare physically plausible candidate models, and understand the limits of every result. All numbers are computed by the verified ZStudio engine (each result carries a provenance stamp) — the AI only guides the workflow and interprets. Results are saved as .zstudy and open seamlessly in the ZStudio desktop app.

Developed by FieldCure Co., Ltd.

Requirements

• Windows 10/11 (x64) — this is a Windows-only package. It uses the native Intel MKL (x64) math provider and Windows-based machine licensing; macOS and Linux are not supported.
• .NET SDK 10 or later — the server is launched with dnx, which runs the NuGet package without installing it globally and requires the SDK (not just the runtime).
• An MCP host (Claude Desktop, VS Code, or any stdio MCP client).

Configure your MCP host

Many hosts can add this server automatically from the NuGet MCP registry. To configure manually, run it from NuGet without installing, via dnx:

{
  "mcpServers": {
    "zstudio": {
      "command": "dnx",
      "args": ["FieldCure.Mcp.ZStudio"],
      "env": {
        "ZSTUDIO_LICENSE_KEY": "<your license key>",
        "ZSTUDIO_WORKDIR": "C:\\Users\\<you>\\Documents\\ZStudio"
      }
    }
  }
}

All environment variables are optional:

• Omit ZSTUDIO_LICENSE_KEY to run on the 15-day trial.
• Omit ZSTUDIO_WORKDIR to default to a ZStudio folder under your Documents (created on first use). This is where studies are read/written when a tool is called without an explicit path.
• Omit ZSTUDIO_AUTOSAVE — auto-save is on by default (no value needed to enable it). Set it to off only to explore a study without modifying the file on disk; save_study is then the explicit way to persist.

(Exact config syntax varies by host — see your MCP host's documentation.)

Environment variables

Tools

The model works through short id-handles and token-light summaries; raw spectra stay on the server. Charts travel as Plotly specs that chart-capable hosts (Claude Desktop, Cowork, VS Code, …) render inline.

• Session & documents — create_from_file (import a raw file; optionally opens the study in the same call), open_study, list_studies, list_tree, get_dataset (token-light summary, optional geometric shape), get_dataset_metadata, get_curve (decimated / windowed measured points, column-oriented), get_analysis (read back a dataset's stored ECM / Loewner / K-K / DRT / Z-HIT results — and the options each was produced with — without re-running), save_study, export_study (write the study to a re-analyzable .xlsx workbook), list_session, close_study, open_in_app (launch the ZStudio desktop app).
• Editing — new_study, import_data, add_folder, rename_item, move_item, remove_item, set_active_dataset, set_dataset_properties, get_study_info, set_study_info.
• Data curation (masking) — set_frequency_exclusions / set_point_exclusions / clear_exclusions mask measured points (raw spectrum only) without deleting them (reversible; new analyses use only non-excluded points). Stored analyses are snapshots and are not recomputed, so re-run the analysis to apply a new mask. get_curve include_excluded=true surfaces masked points with per-point indices to curate them.
• Plotting — plot (Nyquist / Bode / admittance; overlay multiple datasets, overlay a stored analysis reconstruction, or a dataset-level residual plot).
• Analysis — zhit (apply=false tunes options non-destructively), set_analysis_source, kk (Kramers–Kronig; R/C-vs-τ Voigt distribution), drt_tikhonov (continuous γ(τ) with a curve-shape description), drt_loewner (discrete RC/RL poles), estimate_inductance (series/stray diagnostic), export_inductive_free (spectrum with the inductive stray Ls + Rp|Lp + Rx|Lx removed, Rs kept), guess_ecm (data-derived initial values, no fit), evaluate_ecm (χ²/uncertainty at adjusted values, no fit), fit_ecm (with optional circuit schematic; seed_from continues from the stored state).
• Batch — batch_run fans one analysis (kk / drt_tikhonov / guess_ecm / fit_ecm) out across many datasets (or the whole study) in parallel, returning a token-light per-dataset summary. For ECM, omit the circuit to fit each dataset's own stored model, or pass one to apply the same circuit to all.
• Circuits (CDC) — parse_circuit, render_circuit, circuit_reference, simulate_circuit, list_models (built-in model catalog with typical values and recommended frequency windows).
• Licensing — license_status (reports licensed / trial / unlicensed; always callable).

Studies and analysis results auto-save to their .zstudy after each mutating tool call (disable with ZSTUDIO_AUTOSAVE=off).

Vendor formats auto-detected on import: BioLogic (.mpr/.mpt), Gamry (.DTA), Scribner/ZView (.z), Ivium, EcoChemie, Elchemea, MinTech, and generic CSV/TSV.

License & support

Commercial software. The MCP tools require a valid ZStudio license that includes the AI (MCP) add-on; a time-limited trial runs when no key is supplied.

• To purchase a license (including the AI/MCP add-on), contact MinTech: support@g-mintech.co.kr
• Developer: FieldCure Co., Ltd. — https://www.fieldcure.com — support@fieldcure.com

© FieldCure Co., Ltd. All rights reserved.