surfer-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@surfer-mcp Grid examples/sample_points.csv with kriging, export a contour map to output/carte.png"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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
.srfGestion 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.Applicationdoit ê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
Ouvrez (ou créez) le fichier
%APPDATA%\Claude\claude_desktop_config.json.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"
}
}
}
}Redémarrez Claude Desktop. Le serveur
surferdoit 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_mcpPuis vérifiez avec /mcp dans Claude Code.
Variables d'environnement
Variable | Défaut | Rôle |
|
| Dossier de travail : les chemins relatifs des outils y sont résolus. |
|
|
|
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 dansoutput/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 dansoutput/coupe.pnget les données dansoutput/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 |
| Version de Surfer, état, visibilité, dossier de travail, nombre de documents. |
| Liste des documents ouverts (index, nom, chemin, état de sauvegarde). |
| Affiche ou masque la fenêtre Surfer. |
| Interpole un fichier XYZ en grille |
| Crée une carte (colorée, contours seuls ou contours remplis). |
| Crée une coupe géologique le long d'une ligne droite. |
| Crée une vue 3D de la grille. |
| Exporte un document ouvert (format déduit de l'extension). |
| Enregistre un document en |
| 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)etElevation (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 |
|
|
| Surfer n'est pas installé, non licencié, ou son interface COM n'est pas enregistrée. Lancez Surfer une fois manuellement. |
| Moins de 4 lignes numériques, mauvais séparateur ou colonnes mal indiquées. |
Carte remplie en gris | Comportement de Surfer 13 pour |
Accès refusé à l'écriture | Choisissez un dossier accessible dans |
Le serveur ne démarre pas dans Claude | Vérifiez le chemin de |
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 -qStructure :
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émonstrationLicence
MIT — voir LICENSE.
Available Tools
10 toolsclose_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
Scored across 10 tools
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.
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.
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.
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
Related MCP Connectors
Location tools for Claude and other MCP clients, strongest in the US and Great Britain. Geocode whole lists with a confidence score per row, filter by distance, get road distances and drive-time areas, and plan multi-driver routes with Google Maps links. Check flood zones, crime and live warnings, find nearby places and UK registers (NHS, CQC, food hygiene), and keep shareable maps. Reads and writes Google Sheets. Free: sign in with Google.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
ChartAnt is a remote MCP server that gives your AI assistant 51 tools to draw charts, diagrams and maps as real PNG images with their own link, ready for email, Slack, slides or a README. - 40+ chart and diagram types: line, bar, column, pie, area, scatter, funnel, sankey, treemap, waterfall, gantt, heatmap, KPI cards, dashboards, flowcharts, mind maps, org charts and more. - Maps of every country: world maps, the states, provinces or regions of any country, and pin maps from coordinates. Region names in 20+ languages, with "did you mean" hints for names that don't match. - Charts that stay updated: sign in once and your assistant can save a chart at a fixed link. Later, say "add 10% to this month's sales" and the image at the same link updates. Copies can go to Slack, Teams, Discord or email on every change or on a schedule. - Nothing to install and no API key: paste the URL into Claude, ChatGPT, Cursor, VS Code, Windsurf or n8n. - EU-hosted. Chart data is used only to draw the image and is never logged.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables 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.6MIT
- AlicenseAqualityDmaintenanceLets Claude Code, Codex, and other MCP clients control GeoGebra to create geometric constructions, function graphs, 3D graphics, dynamic mechanisms, and save .ggb or export .png.155MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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
- FlicenseNot gradedqualityAmaintenanceEnables 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.-