QGISMCP

Instructions

Implementation Reference

• src/qgis_mcp/qgis_mcp_server.py:167-172 (handler)

  MCP tool handler for create_new_project that proxies the command to the QGIS plugin server

  @mcp.tool()
  def create_new_project(ctx: Context, path: str) -> str:
      """Create a new project a save it"""
      qgis = get_qgis_connection()
      result = qgis.send_command("create_new_project", {"path": path})
      return json.dumps(result, indent=2)

• qgis_mcp_plugin/qgis_mcp_plugin.py:133-149 (registration)

  Registration of the create_new_project command handler in the QGIS plugin's execute_command method

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

• qgis_mcp_plugin/qgis_mcp_plugin.py:416-438 (handler)

  Core implementation of create_new_project in QGIS plugin: clears existing project, sets new path, refreshes canvas, and saves the project file

  def create_new_project(self, path, **kwargs):
      """
      Creates a new QGIS project and saves it at the specified path.
      If a project is already loaded, it clears it before creating the new one.
      
      :param project_path: Full path where the project will be saved
                          (e.g., 'C:/path/to/project.qgz')
      """
      project = QgsProject.instance()
      
      if project.fileName():
          project.clear()
      
      project.setFileName(path)
      self.iface.mapCanvas().refresh()
      
      # Save the project
      if project.write():
          return {
              "created": f"Project created and saved successfully at: {path}",
              "layer_count": len(project.mapLayers())
          }
      else: