Function handleCat

packages/mcp/src/tools/reading.ts:352–421

(args: Record<string, unknown>)

}

async function handleCat(args: Record<string, unknown>) {
  const parsedArgs = catArgsSchema.safeParse(args)
  if (!parsedArgs.success) {
    return {
      content: [
        {
          type: 'text',
          text: 'Invalid args for deepnote_cat: path is required and optional fields must match expected types',
        },
      ],
      isError: true,
    }
  }
  const filePath = parsedArgs.data.path
  const notebookFilter = parsedArgs.data.notebook
  const blockIdFilter = parsedArgs.data.blockId
  const blockTypeFilter = parsedArgs.data.blockType
  const includeMetadata = parsedArgs.data.includeMetadata

  let file: DeepnoteFile
  try {
    file = await loadDeepnoteFile(filePath)
  } catch (error) {
    const message = error instanceof Error ? error.message : String(error)
    return {
      content: [{ type: 'text', text: `Failed to read file "${filePath}": ${message}` }],
      isError: true,
    }
  }
  const output: string[] = []

  for (const notebook of file.project.notebooks) {
    if (notebookFilter && notebook.name !== notebookFilter && notebook.id !== notebookFilter) {
      continue
    }

    output.push(`## Notebook: ${notebook.name}`)
    output.push('')

    for (const block of notebook.blocks) {
      if (blockIdFilter && block.id !== blockIdFilter && !block.id.startsWith(blockIdFilter)) {
        continue
      }
      if (blockTypeFilter && block.type !== blockTypeFilter) {
        continue
      }

      output.push(`### Block: ${block.type} (${block.id.slice(0, 8)})`)

      if (block.content) {
        output.push('```')
        output.push(block.content)
        output.push('```')
      }

      if (includeMetadata && block.metadata) {
        output.push('**Metadata:**')
        output.push('```json')