Markdown Editor MCP Server

Implementation Reference

• src/markdown_editor/tools/file_ops.py:88-107 (handler)

  Core handler function that validates the path, resolves it, checks existence, and deletes the file using os.remove or directory using shutil.rmtree, returning success or error dict.

  async def delete_item(self, path: str) -> Dict[str, Any]:
      """Delete file or directory"""
      # Validate path safety
      error = self._validate_path(path)
      if error:
          return {"error": error}
  
      try:
          abs_path = self._get_abs_path(path)
          if not os.path.exists(abs_path):
              return {"error": "Item not found"}
  
          if os.path.isdir(abs_path):
              shutil.rmtree(abs_path)
          else:
              os.remove(abs_path)
          return {"success": True, "path": path}
      except Exception as e:
          return {"error": str(e)}

• src/markdown_editor/server.py:466-487 (registration)

  Registers the 'delete_item' tool in the MCP server's list_tools() function, including title, description (implied), input schema requiring 'path' string, and output schema with success boolean and path.

  Tool(
      name="delete_item",
      title="Delete File/Folder",
      inputSchema={
          "type": "object",
          "properties": {
              "path": {
                  "type": "string",
                  "examples": ["./old_file.md", "./temp_folder"],
              }
          },
          "required": ["path"],
          "additionalProperties": False,
      },
      outputSchema={
          "type": "object",
          "properties": {
              "success": {"type": "boolean"},
              "path": {"type": "string"},
          },
      },
  ),

• src/markdown_editor/server.py:541-547 (handler)

  Tool dispatcher in call_tool() that invokes the delete_item function with the provided path argument and wraps the result in MCP CallToolResult.

  elif name == "delete_item":
      res = await delete_item(arguments["path"])
      return CallToolResult(
          content=[TextContent(type="text", text="Item deleted")],
          structuredContent=res,
          isError="error" in res,
      )

• src/markdown_editor/tools/file_ops.py:125-126 (helper)

  Thin wrapper function that delegates to the singleton FileOperationsTool instance's delete_item method.

  async def delete_item(path: str):
      return await _instance.delete_item(path)