Mnemosyne MCP

Instructions

Implementation Reference

• src/neem/mcp/tools/hocuspocus.py:850-907 (handler)

  The main handler function for the 'get_block' MCP tool. It authenticates, connects to the specified graph and document, retrieves the block information using DocumentReader.get_block_info(), and returns a dictionary with graph_id, document_id, and the block details (including XML content, attributes, text, and prev/next IDs).

  @server.tool(
      name="get_block",
      title="Get Block by ID",
      description=(
          "Read a specific block by its data-block-id. Returns detailed info including "
          "the block's XML content, attributes, text content, and context (prev/next block IDs). "
          "Use this for targeted reads without fetching the entire document."
      ),
  )
  async def get_block_tool(
      graph_id: str,
      document_id: str,
      block_id: str,
      context: Context | None = None,
  ) -> dict:
      """Get detailed information about a block by its ID."""
      auth = MCPAuthContext.from_context(context)
      auth.require_auth()
  
      if not graph_id or not graph_id.strip():
          raise ValueError("graph_id is required")
      if not document_id or not document_id.strip():
          raise ValueError("document_id is required")
      if not block_id or not block_id.strip():
          raise ValueError("block_id is required")
  
      try:
          await hp_client.connect_document(graph_id.strip(), document_id.strip())
  
          channel = hp_client.get_document_channel(graph_id.strip(), document_id.strip())
          if channel is None:
              raise RuntimeError(f"Document channel not found: {graph_id}/{document_id}")
  
          reader = DocumentReader(channel.doc)
          block_info = reader.get_block_info(block_id.strip())
  
          if block_info is None:
              raise RuntimeError(f"Block not found: {block_id}")
  
          result = {
              "graph_id": graph_id.strip(),
              "document_id": document_id.strip(),
              "block": block_info,
          }
          return result
  
      except Exception as e:
          logger.error(
              "Failed to get block",
              extra_context={
                  "graph_id": graph_id,
                  "document_id": document_id,
                  "block_id": block_id,
                  "error": str(e),
              },
          )
          raise RuntimeError(f"Failed to get block: {e}")