FieldCure.Mcp.ZStudio 1.0.0

ZStudio MCP Server

An MCP (Model Context Protocol) server that brings the ZStudio electrochemical impedance spectroscopy (EIS) analysis engine to AI assistants such as Claude and VS Code. You ask in plain language; the assistant calls ZStudio to do the work. Analysis results are computed by the ZStudio engine. Measured values are read from source files; the AI guides the workflow and interprets the results.

Developed by FieldCure Co., Ltd.

What you can do

• Import measurements from common potentiostat formats into a ZStudio study (.zstudy) and organize datasets in folders.
• Check data quality with Kramers–Kronig and Z-HIT, and mask bad points without deleting them.
• Find time constants with DRT (Tikhonov continuous distribution or Loewner discrete poles), including detection and removal of cable / fixture inductance.
• Fit equivalent circuits: get data-derived starting values, compare candidate circuits, fit them, and read the uncertainty of every parameter — one dataset at a time or across a whole study.
• Plot Nyquist / Bode / admittance charts, overlays and residuals; chart-capable hosts show them inline.
• Read charge/discharge records (BioLogic GCPL) that sit next to the EIS files — every original point, page by page or as a full CSV export.
• Keep working in the desktop app: studies saved by the server open in the ZStudio app. The app is optional; the server runs on its own.

Supported files

Formats are detected automatically.

Install

• 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). Check with dotnet --version.
• An MCP host — Claude Desktop, VS Code, or any stdio MCP client.

There is nothing else to install: the host starts the server with dnx and downloads the package on first use.

Configure your MCP host

Many hosts can add this server automatically from the NuGet MCP registry. To configure it manually:

Claude Desktop — add to %APPDATA%\Claude\claude_desktop_config.json:

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

VS Code — add to .vscode/mcp.json (or your user MCP configuration):

{
  "servers": {
    "zstudio": {
      "type": "stdio",
      "command": "dnx",
      "args": ["FieldCure.Mcp.ZStudio"],
      "env": {
        "ZSTUDIO_LICENSE_KEY": "<your license key>"
      }
    }
  }
}

Restart the host (or reconnect the server) after editing. Exact syntax varies by host — see your host's documentation.

All environment variables are optional:

Getting started

Ask your assistant in plain language, for example:

• "Import C:\data\cell01.mpr into a new study and summarize the datasets."
• "Run a Kramers–Kronig check on every dataset and tell me which ones look unreliable."
• "Use DRT to find how many time constants this spectrum has."
• "Suggest two or three equivalent circuits for this cell, fit them, and compare."
• "Read C:\data\cell01_GCPL.mpr and export the whole charge/discharge record to CSV."
• "Open this study in the ZStudio app."

The assistant chooses the tools; you can also name a tool or an option directly.

Saving, charts and data handling

• Saving. Imports, edits and analyses are saved to the study's .zstudy after each change (auto-save). If the same file was changed outside the session — for example saved from the ZStudio app — the save is held back instead of overwriting it and the assistant is told, so you can reload the study or, if you choose, overwrite it.
• Charts. Hosts that render MCP charts show them inline. Other hosts get the numeric summary plus a standalone HTML chart file in an artifacts folder under the working folder.
• Charge/discharge data is held in memory for the session only; it is never written into a .zstudy. Exports go to CSV files you choose.
• Where data goes. Your measurement files are read and analyzed by the server on your PC. What the server returns to the assistant — summaries and analysis results by default, and any measured points, curve rows or chart data you or the assistant request — is passed to the AI model through your MCP host, under that host's data policy. Ask for summaries rather than raw rows when you want to limit what is sent.

License and troubleshooting

ZStudio MCP is commercial software. It needs a ZStudio license that includes the AI (MCP) add-on; a regular ZStudio app license alone does not enable it.

• Trial. Without a key, a 15-day trial is issued for this PC.
• Internet connection. Issuing the trial for the first time and activating a paid key both need an online connection to the FieldCure license server; the server also contacts it when the license needs renewing. In between it works offline, within the validity of the cached license.
• After the trial, tool calls are refused. Ask the assistant to run license_status to see the state and days left; after purchase, set ZSTUDIO_LICENSE_KEY and restart the host.
• To purchase (including the AI/MCP add-on), contact MinTech: zstudio@g-mintech.co.kr

Common problems:

• The server does not start / dnx is not found — install the .NET SDK 10 or later (the runtime alone is not enough), then restart the host.
• New tools are missing after an update — restart the host or reconnect the server so it reloads the tool list.
• "auto-save blocked" — the .zstudy was changed outside this session. Reopen the study to take the version on disk, or save with force to overwrite it.

Tool reference

The assistant normally picks these for you. EIS tools return compact summaries and short id-handles; the full spectrum stays in the session unless a tool such as get_curve is asked for points. The charge/discharge tools return every original row on request.

• 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 (compact summary, optional geometric shape), get_dataset_metadata, get_curve (decimated / windowed measured points), get_analysis (read back stored ECM / Loewner / K-K / DRT / Z-HIT results and the options used, without re-running), save_study, export_study (write the study to a re-analyzable .xlsx workbook), list_session, close_study, open_in_app (open in 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 without deleting them (reversible). Stored analyses are snapshots, so re-run an analysis to apply a new mask. get_curve include_excluded=true lists masked points with their indices.
• Plotting — plot (Nyquist / Bode / admittance; overlay datasets or a stored analysis reconstruction, or show residuals).
• Analysis — zhit (apply=false tunes options without changing the data), set_analysis_source, kk (Kramers–Kronig), drt_tikhonov (continuous γ(τ) with a curve-shape description), drt_loewner (discrete RC/RL poles), estimate_inductance (series / stray inductance diagnostic), export_inductive_free (spectrum with the inductive stray removed, Rs kept), guess_ecm (data-derived initial values, no fit), evaluate_ecm (χ² and uncertainty at given values, no fit), fit_ecm (fit, with an optional circuit schematic; seed_from continues from the stored state).
• Batch — batch_run runs one analysis (kk / drt_tikhonov / guess_ecm / fit_ecm) across many datasets or the whole study in parallel. For ECM, omit the circuit to fit each dataset's own stored model, or pass one to apply it to all.
• Circuits (CDC) — parse_circuit, render_circuit, circuit_reference, simulate_circuit, list_models (built-in models with typical values and recommended frequency windows).
• Charge/discharge (DC time series) — read_dc_file reads a BioLogic GCPL .mpr into the session (a dc_… handle) and summarizes it: channels with meaning, unit, origin and source column; half cycles; loops; steps. get_dc_curve returns every original row in file order, paged (offset / limit, default 200 rows per page — a page size, not a cap; follow nextOffset; no decimation), optionally filtered by time, half cycle, step or loop, with an optional derived interval-averaged current. export_dc_data writes every row to CSV plus a column-description .meta.json. close_dc releases a series; list_session lists open series next to studies. Voltages are as recorded; control/V/mA is reported as current / voltage setpoints, never as a measured current.
• Licensing — license_status (licensed / trial / unlicensed; always callable).

Support

• Purchase and licensing: MinTech — zstudio@g-mintech.co.kr
• Developer: FieldCure Co., Ltd. — https://www.fieldcure.com — support@fieldcure.com

© FieldCure Co., Ltd. All rights reserved.