Ocean Insight Spectrometer MCP Server

Let an AI agent acquire spectra, set or auto-tune the integration time, store dark and reference spectra, and measure absorbance and transmittance with peak positions and FWHM on Ocean Insight (Ocean Optics) spectrometers. It works through the open-source python-seabreeze library. Its 16 documented tools cover detector, integration, time, cooling.

People who work with detector, integration and time and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

One of 32 MCP servers published from k-dense-ai/lab-instrument-mcps. Stars and repository activity are shared across all of them. See all 32 →

VERIFIED ACTIVE

LAST COMMIT 2026-09-26 · VERIFIED 2026-09-30

Apache-2.0 · Python servers · how we verify → /methodology

01 · Install Ocean Insight Spectrometer

Claude Code

claude mcp add k-dense-ai-lab-instrument-mcps-servers-c -- uvx labmcp-ocean-spectrometer

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "k-dense-ai-lab-instrument-mcps-servers-c": {
      "command": "uvx",
      "args": [
        "labmcp-ocean-spectrometer"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-09-25 - young repo, little track record yet

license Apache-2.0 - declared in the repository

pypi package labmcp-ocean-spectrometer - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.K-Dense-AI is GitHub-verified and matches the repo owner

03 · What Ocean Insight Spectrometer can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 16 documented tools spanning detector, integration, time, cooling, including acquire_spectrum, auto_integration_time, detector_cooling_off, find_peaks.

Capability map

Tools grouped from the project's README - what Ocean Insight Spectrometer lets an agent do.

read & search

5 tools - e.g. Find peaks (or dips) with position, height, prominence and FWHM in the most recent spectrum (intensity, absorbance or transmittance). Acquires a fresh intensity; Return the most recent raw commands sent…

find_peaks · get_command_log · get_connection_info · get_device_info · list_spectrometers

Detector

3 tools - e.g. Switch the detector thermo-electric cooler off (the detector warms to ambient). Does nothing on spectrometers without a TEC.; Read the detector temperature from the thermo-electric cooler (TE-cooled…

detector_cooling_off · read_detector_temperature · set_detector_cooling

Measure

2 tools - e.g. Measure the absorbance spectrum A = -log10((S - D) / (R - D)) of the sample now in the beam, using the stored dark D and reference R (same settings). Ask the us; Measure the transmittance spectrum %T =…

measure_absorbance · measure_transmittance

Store

2 tools - e.g. Record and store a DARK spectrum (kept in memory) for absorbance/transmittance. BEFORE calling, ask the user to BLOCK THE LIGHT PATH (close the shutter, switch ; Record and store the REFERENCE (100 %…

store_dark_reference · store_reference

Acquire

1 tool - e.g. Acquire an intensity spectrum (raw counts) with optional averaging, boxcar smoothing and corrections. Returns downsampled (wavelength, counts), summary statisti

acquire_spectrum

Auto

1 tool - e.g. Adjust the integration time until the brightest raw pixel (optionally within a wavelength window) is within the target band of saturation (default 70-85 %). Sta

auto_integration_time

Reconnect

1 tool - e.g. Close and re-open the connection to the instrument (e.g. after it was power cycled or a cable was re-plugged).

reconnect

update

1 tool - e.g. Set the detector integration time (ms), within the device limits from get_device_info. Stored dark/reference spectra become unusable until re-taken at the new t

set_integration_time

Limitations (from the README)

- Raw counts. Intensities are detector counts, not irradiance. Radiometric calibration is out of scope. - Saturation is judged on the raw ADC counts of every averaged scan: a pixel is saturated at ≥ 98 % of max_intensity. Saturated pixels are flagged, and they're excluded from absorbance/transmittance (with boxcar smoothing, so are the pixels within the boxcar half width of them). seabreeze notes that some detectors

04 · Who maintains Ocean Insight Spectrometer

Ocean Insight Spectrometer is maintained by k-dense-ai. We track 32 MCP servers from k-dense-ai - 32 actively maintained, 9 combined GitHub stars, oldest repo from Sep 2026. Full record: all servers from k-dense-ai.

  1. Tecan Cavro Syringe Pump MCP server for Tecan Cavro syringe pumps (XLP 6000, XMP 6000, XCalibur) over the DT protocol. ★ 9
  2. Micro-Manager Microscope MCP server for microscopes controlled by Micro-Manager (pymmcore-plus). ★ 9
  3. Opentrons OT-2 / Flex MCP server for Opentrons OT-2 and Flex liquid-handling robots (HTTP API). ★ 9
  4. Atlas Scientific EZO Sensors MCP server for Atlas Scientific EZO sensor circuits (pH, ORP, DO, EC, RTD, HUM, CO2, PRS) over UART. ★ 9
  5. New Era Syringe Pump MCP server for New Era Pump Systems syringe pumps (NE-1000 family, RS-232). ★ 9
  6. Alicat Mass Flow & Pressure Controller MCP server for Alicat mass flow and pressure meters/controllers. ★ 9

05 · Facts

category
other - actively maintained as of 2026-09-30.
registry
io.github.K-Dense-AI/labmcp-ocean-spectrometer (active, first published 2026-09-26 · 3 versions)
packages
pypi:labmcp-ocean-spectrometer

06 · Ocean Insight Spectrometer FAQ

Is Ocean Insight Spectrometer still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-26. We re-verify nightly.

What can Ocean Insight Spectrometer do?

An agent gets 16 documented tools spanning detector, integration, time, cooling, including acquire_spectrum, auto_integration_time, detector_cooling_off, find_peaks.

How do I install Ocean Insight Spectrometer?

Run `uvx labmcp-ocean-spectrometer`. You can also paste the ready-made client config above.

Does Ocean Insight Spectrometer run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Ocean Insight Spectrometer