Skip to main content
Glama
surfer-mcp

surfer-mcp

by office31

surfer-mcp

Serveur MCP local qui connecte Claude (Claude Desktop ou Claude Code) à Golden Software Surfer 13+ sous Windows.

Il permet à Claude de piloter Surfer : interpoler des données XYZ en grille, produire des cartes structurales, tracer des coupes géologiques, générer des vues 3D et exporter les résultats en PNG, JPG, PDF, TIF, SVG ou EMF.

Testé avec Surfer 13.06.618 et Python 3.14 sous Windows 10/11.

Dépôt : https://github.com/office31/claude-surfer13-mcp

Fonctionnalités

  • Grille : interpolation de points XYZ (kriging, IDW, courbure minimale, plus proche voisin, triangulation…)

  • Carte structurale : raster coloré + lignes de contours superposées

  • Coupe géologique : profil le long d'une ligne A–A′, avec carte de localisation, axes, titre et exagération verticale

  • Vue 3D : surface à partir d'une grille

  • Exports : PNG, JPG, PDF vectoriel, TIF, SVG, EMF, et fichiers de projet .srf

  • Gestion des documents : liste, export, sauvegarde et fermeture des documents ouverts dans Surfer

Related MCP server: GeoGebra MCP Server

Prérequis

  • Windows 10 ou 11

  • Golden Software Surfer 13 ou plus récent, installé et licencié (l'interface COM Surfer.Application doit être disponible)

  • Python 3.10+ (64 bits)

Installation

git clone https://github.com/office31/claude-surfer13-mcp.git
cd claude-surfer13-mcp

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -e .

Vérification rapide :

python -c "import surfer_mcp; print('ok')"

Configuration de Claude Desktop

  1. Ouvrez (ou créez) le fichier %APPDATA%\Claude\claude_desktop_config.json.

  2. Ajoutez le serveur en adaptant les chemins :

{
  "mcpServers": {
    "surfer": {
      "command": "C:\\Users\\VOTRE_NOM\\claude-surfer13-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "surfer_mcp"],
      "env": {
        "SURFER_MCP_WORKSPACE": "C:\\Users\\VOTRE_NOM\\Documents\\SurferMCP",
        "SURFER_MCP_VISIBLE": "1"
      }
    }
  }
}
  1. Redémarrez Claude Desktop. Le serveur surfer doit apparaître dans la liste des outils (icône MCP).

Un modèle est fourni : claude_desktop_config.example.json.

Configuration de Claude Code

claude mcp add surfer -e SURFER_MCP_WORKSPACE="C:\Users\VOTRE_NOM\Documents\SurferMCP" -- "C:\Users\VOTRE_NOM\claude-surfer13-mcp\.venv\Scripts\python.exe" -m surfer_mcp

Puis vérifiez avec /mcp dans Claude Code.

Variables d'environnement

Variable

Défaut

Rôle

SURFER_MCP_WORKSPACE

%USERPROFILE%\Documents\SurferMCP (ou ~/SurferMCP)

Dossier de travail : les chemins relatifs des outils y sont résolus.

SURFER_MCP_VISIBLE

1

1 affiche Surfer, 0 le lance en arrière-plan.

Surfer est démarré automatiquement au premier appel d'outil. Le serveur ne ferme jamais une instance de Surfer qu'il n'a pas lancée.

Démarrage rapide

Le dépôt contient un jeu de données synthétique : examples/sample_points.csv (X 0–5000 m, Y 0–4000 m, Z en mètres, séparé par virgules avec en-tête).

Exemples de demandes à Claude :

Crée une grille par kriging (300 × 300) à partir de examples/sample_points.csv, puis une carte colorée intitulée « Carte structurale » et exporte-la dans output/carte.png.

Trace la coupe A–A′ de (500, 500) à (4500, 3200) sur grids/sample_points.grd, avec une exagération verticale de 2.5. Exporte l'image dans output/coupe.png et les données dans output/coupe.dat.

Fais une vue 3D de la grille et exporte output/surface.png.

Liste les documents ouverts, exporte le premier en PDF, puis ferme-le.

Après exécution, les fichiers générés se trouvent dans %USERPROFILE%\Documents\SurferMCP (ou dans le dossier défini par SURFER_MCP_WORKSPACE).

Outils MCP

Outil

Description

surfer_status

Version de Surfer, état, visibilité, dossier de travail, nombre de documents.

list_documents

Liste des documents ouverts (index, nom, chemin, état de sauvegarde).

set_surfer_visible

Affiche ou masque la fenêtre Surfer.

create_grid

Interpole un fichier XYZ en grille .grd.

create_contour_map

Crée une carte (colorée, contours seuls ou contours remplis).

create_cross_section

Crée une coupe géologique le long d'une ligne droite.

create_surface_map

Crée une vue 3D de la grille.

export_document

Exporte un document ouvert (format déduit de l'extension).

save_plot

Enregistre un document en .srf.

close_document

Ferme un document, avec sauvegarde optionnelle.

Paramètres utiles

  • Colonnes : indices à partir de 1 (x_col=1, y_col=2, z_col=3).

  • Algorithmes de grille : kriging (défaut), idw, min_curvature, shepards, natural_neighbor, nearest_neighbor, regression, radial_basis, triangulation, moving_average, data_metrics, local_polynomial.

  • Styles de carte :

    • color (recommandé) : raster coloré + lignes de contours ;

    • lines : contours noirs uniquement ;

    • filled : contours remplis — Surfer 13 les rend en niveaux de gris.

  • Formats d'export : .png, .jpg, .pdf, .tif, .svg, .emf.

Format des données

  • Fichiers .csv, .txt, .tsv, .dat, .xyz.

  • Séparateur détecté automatiquement : virgule, point-virgule, tabulation ou espace.

  • Ligne d'en-tête facultative, lignes non numériques ignorées, commentaires # ignorés.

  • Au moins 4 points numériques.

  • Les coordonnées sont exprimées dans les unités cartographiques de votre projet ; les libellés d'axes par défaut sont Distance (m) et Elevation (m).

Chemins de fichiers

  • Les chemins relatifs sont résolus dans SURFER_MCP_WORKSPACE.

  • Les chemins absolus sont acceptés.

  • Les dossiers de sortie sont créés automatiquement à l'intérieur du dossier de travail ; hors de ce dossier, le dossier parent doit déjà exister.

Dépannage

Symptôme

Cause probable / solution

pywin32 is required…

pip install pywin32 dans l'environnement virtuel.

ActiveX component can't create object

Surfer n'est pas installé, non licencié, ou son interface COM n'est pas enregistrée. Lancez Surfer une fois manuellement.

Insufficient data in worksheet

Moins de 4 lignes numériques, mauvais séparateur ou colonnes mal indiquées.

Carte remplie en gris

Comportement de Surfer 13 pour style="filled" ; utilisez style="color".

Accès refusé à l'écriture

Choisissez un dossier accessible dans SURFER_MCP_WORKSPACE.

Le serveur ne démarre pas dans Claude

Vérifiez le chemin de python.exe dans la configuration et redémarrez Claude Desktop.

Limites connues

  • Windows uniquement (automatisation COM).

  • Coupes le long d'une ligne droite uniquement dans cette version.

  • Une seule opération Surfer à la fois (les appels sont sérialisés).

  • Après SaveAs, Surfer renomme le document : les outils renvoient le nom final.

  • Le serveur ne ferme pas les documents que vous avez ouverts vous-même.

Développement et tests

pip install -e ".[dev]"
pytest -q

# Tests d'intégration réels (lance Surfer)
$env:SURFER_MCP_TEST_COM = "1"
pytest -q

Structure :

src/surfer_mcp/surfer.py   # session COM, grille, cartes, coupes, exports
src/surfer_mcp/server.py   # outils MCP
tests/                     # tests unitaires et d'intégration (Surfer + stdio MCP)
examples/                  # jeu de données de démonstration

Licence

MIT — voir LICENSE.

Available Tools

10 tools
close_documentC

Close an open Surfer document, optionally saving it first.

Inputs: save, document. Returns: result

create_contour_mapB

Create a map from a .grd grid in a new Surfer plot document.

Args: grid_file: Input .grd grid. title: Optional map title. style: "color" renders a coloured raster with contour lines, "lines" draws plain contours, "filled" fills contours (grayscale in Surfer 13). output_image: Optional export path; format inferred from extension (png, jpg, pdf, tif, svg, emf). save_plot: Optional .srf plot path.

Inputs: grid_file (required), style, title, save_plot, +1 more. Returns: result

create_cross_sectionA

Create a geological cross-section along a straight line through a grid.

The plot combines a location map (with the section line) and a profile below it.

Args: grid_file: Input .grd grid. start_x: Section start X in map units. start_y: Section start Y in map units. end_x: Section end X in map units. end_y: Section end Y in map units. title: Section title, e.g. "A-A'". style: Map style behind the section: "color", "lines" or "filled". vertical_exaggeration: Vertical scale factor (1.0 = true scale). x_label: Horizontal axis label. y_label: Vertical axis label. output_image: Optional export path (png, jpg, pdf, tif, svg, emf). save_plot: Optional .srf plot path. save_profile_data: Optional tab-delimited .dat path for the sampled profile values.

Inputs: end_x (required), end_y (required), start_x (required), start_y (required), +9 more. Returns: result

create_gridB

Interpolate XYZ point data into a binary Surfer grid (.grd).

Args: data_file: CSV, TSV or whitespace text file containing X, Y, Z columns. output_grid: Destination .grd path (workspace-relative or absolute). Defaults to grids/.grd. x_col: 1-based X column. y_col: 1-based Y column. z_col: 1-based Z column. algorithm: Gridding algorithm; kriging by default. cols: Grid columns (10-4000). rows: Grid rows (10-4000).

Inputs: data_file (required), cols, rows, x_col, +4 more. Returns: result

create_surface_mapC

Create a 3D surface view from a .grd grid.

Inputs: grid_file (required), title, save_plot, output_image. Returns: result

export_documentA

Export an open Surfer document to png, jpg, pdf, tif, svg or emf.

Args: output_file: Destination path; the extension selects the export filter. document: Document name, 1-based index, or "active".

Inputs: output_file (required), document. Returns: result

list_documentsA

List the documents currently open in Surfer with their index, name, path and saved state.

Inputs: no named parameters. Returns: result

save_plotC

Save an open Surfer document as a .srf plot file.

Inputs: output_file (required), document. Returns: result

set_surfer_visibleA

Show or hide the Surfer application window. Surfer starts automatically if needed.

Inputs: visible. Returns: result

surfer_statusA

Report Surfer availability, version, visibility, workspace and open document count.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 10 tools

    Disambiguation4/5

    The three map-producing tools (create_contour_map, create_surface_map, create_cross_section) share the same input (a .grd grid) but their descriptions make the distinct outputs clear. The only real friction is export_document vs. save_plot, since 'save_plot' also appears as a parameter name inside the create_* tools, which could momentarily confuse selection.

    Naming Consistency4/5

    Nine of ten tools follow a clean verb_noun pattern (list_documents, create_grid, export_document, close_document, etc.). The outlier is surfer_status, which uses a noun-first form instead of something like get_status or report_status.

    Tool Count5/5

    Ten tools is a well-scoped surface for driving a desktop gridding/mapping application: three lifecycle/document tools, one data-to-grid tool, three map builders, and three output tools. Every tool maps to a distinct step in the workflow and none feel redundant.

    Completeness4/5

    The core pipeline (XYZ data -> grid -> map -> export/save -> close) is fully covered, plus status and visibility control. The notable gap is an open_document tool for re-opening existing .srf plots, and there is no way to inspect or delete saved workspace files, but agents can work around these by regenerating plots.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables users to control AutoCAD, GstarCAD, or ZWCAD through natural language via Claude Desktop. It provides tools for drawing geometric shapes, adding text and dimensions, and managing CAD files using the Windows COM interface.
      6
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude Desktop or Claude Code to inspect, visualize, and process point clouds and meshes in natural language, with tools for metadata, density, subsampling, registration, distance computation, normals, filtering, merging, and format conversion. Tuned for cave, tunnel, and underground 3D surveys, it can run batch command-line operations without requiring an open GUI.
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants such as Claude for Desktop or Cursor to control CAD applications (AutoCAD, ZWCAD, GstarCAD, BricsCAD) on Windows through 7 unified tools exposing 56 commands. Supports drawing shapes, managing layers, blocks and entities, extracting data, exporting to Excel, and saving drawings via natural language or direct tool calls.
      -