get_layer_features

Retrieve features from vector layers in QGIS for analysis and visualization, with optional result limits to manage data output.

Instructions

Retrieve features from a vector layer with an optional limit.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`layer_id`	Yes
`limit`	No

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})

QGISMCP