FieldCure.Mcp.ZStudio 0.2.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"
      }
    }
  }
}

Both 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.

(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), save_study, 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.
• Plotting — plot (Nyquist / Bode / admittance; overlay multiple datasets, overlay a stored analysis reconstruction, or a dataset-level residual plot).
• Analysis — zhit, 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), 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).
• 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.