QGISMCP

Instructions

Implementation Reference

• qgis_mcp_plugin/qgis_mcp_plugin.py:335-377 (handler)

  Core handler implementation that executes the logic to fetch layer features from QGIS project, including attributes and geometry.
  def get_layer_features(self, layer_id, limit=10, **kwargs): """Get features from a vector layer""" project = QgsProject.instance() if layer_id in project.mapLayers(): layer = project.mapLayer(layer_id) if layer.type() != QgsMapLayer.VectorLayer: raise Exception(f"Layer is not a vector layer: {layer_id}") features = [] for i, feature in enumerate(layer.getFeatures()): if i >= limit: break # Extract attributes attrs = {} for field in layer.fields(): attrs[field.name()] = feature.attribute(field.name()) # Extract geometry if available geom = None if feature.hasGeometry(): geom = { "type": feature.geometry().type(), "wkt": feature.geometry().asWkt(precision=4) } features.append({ "id": feature.id(), "attributes": attrs, "geometry": geom }) return { "layer_id": layer_id, "feature_count": layer.featureCount(), "features": features, "fields": [field.name() for field in layer.fields()] } else: raise Exception(f"Layer not found: {layer_id}")
• qgis_mcp_plugin/qgis_mcp_plugin.py:133-152 (registration)

  Registers the get_layer_features handler in the QGIS MCP server's command handlers dictionary.
  handlers = { "ping": self.ping, "get_qgis_info": self.get_qgis_info, "load_project": self.load_project, "get_project_info": self.get_project_info, "execute_code": self.execute_code, "add_vector_layer": self.add_vector_layer, "add_raster_layer": self.add_raster_layer, "get_layers": self.get_layers, "remove_layer": self.remove_layer, "zoom_to_layer": self.zoom_to_layer, "get_layer_features": self.get_layer_features, "execute_processing": self.execute_processing, "save_project": self.save_project, "render_map": self.render_map, "create_new_project": self.create_new_project, } handler = handlers.get(cmd_type) if handler:
• src/qgis_mcp/qgis_mcp_server.py:222-227 (handler)

  MCP protocol tool handler that proxies get_layer_features calls to the QGIS plugin socket server.
  @mcp.tool() def get_layer_features(ctx: Context, layer_id: str, limit: int = 10) -> str: """Retrieve features from a vector layer with an optional limit.""" qgis = get_qgis_connection() result = qgis.send_command("get_layer_features", {"layer_id": layer_id, "limit": limit}) return json.dumps(result, indent=2)
• src/qgis_mcp/qgis_socket_client.py:121-123 (helper)

  Socket client proxy method for sending get_layer_features command to QGIS plugin.
  def get_layer_features(self, layer_id, limit=10): """Get features from a vector layer""" return self.send_command("get_layer_features", {"layer_id": layer_id, "limit": limit})