Markdown Editor MCP Server

Instructions

Implementation Reference

• src/markdown_editor/tools/edit_tools.py:280-281 (handler)

  Top-level asynchronous handler function for the 'read_element' tool. Delegates to the EditTool instance's read method.

  async def read_element(file_path: str, path: str):
      return await _instance.read(file_path, path)

• src/markdown_editor/tools/edit_tools.py:143-146 (handler)

  Core logic of the read_element tool in EditTool class: loads the cached document and retrieves the specific element using its view_element method.

  async def read(self, file_path: str, path: str) -> Dict[str, Any]:
      doc = self.get_doc(file_path)
      return doc.view_element(path)

• src/markdown_editor/server.py:170-196 (schema)

  Input and output schema definition for the read_element tool, registered via list_tools().

  Tool(
      name="read_element",
      title="Read Specific Element",
      description="Fetches the full content of a specific block by its path.",
      inputSchema={
          "type": "object",
          "properties": {
              "file_path": {"type": "string", "examples": ["./document.md"]},
              "path": {
                  "type": "string",
                  "examples": ["Features > list 1", "Introduction"],
              },
          },
          "required": ["file_path", "path"],
          "additionalProperties": False,
      },
      outputSchema={
          "type": "object",
          "properties": {
              "element": {
                  "type": "object",
                  "description": "The requested element",
              },
              "content": {"type": "string", "description": "Element content"},
          },
      },
  ),

• src/markdown_editor/server.py:583-589 (registration)

  Dispatch/registration in the server's call_tool method: calls the read_element handler when the tool name matches.

  elif name == "read_element":
      res = await read_element(file_path, arguments["path"])
      return CallToolResult(
          content=[TextContent(type="text", text=json.dumps(res, ensure_ascii=False, indent=2))],
          structuredContent=res,
          isError="error" in res,
      )

• src/markdown_editor/server.py:15-26 (helper)

  Import statement bringing the read_element handler into server.py for use in tool dispatch.

  from .tools.edit_tools import (
      get_document_structure,
      read_element,
      replace_content,
      insert_element,
      delete_element,
      undo_changes,
      search_in_document,
      get_element_context,
      move_document_element,
      update_document_metadata,
  )