List, read, and search files in a directory via MCP

{
  "server": "@modelcontextprotocol/server-filesystem",
  "version": "0.2.0",
  "transport": "stdio",
  "launch": "npx -y @modelcontextprotocol/server-filesystem /private/tmp/pathfinder-test",
  "traces": [
    {
      "tool": "list_directory",
      "request": {
        "name": "list_directory",
        "arguments": {
          "path": "/private/tmp/pathfinder-test"
        }
      },
      "response": {
        "content": [
          {
            "type": "text",
            "text": "[FILE] package.json
[FILE] readme.txt
[DIR] src"
          }
        ],
        "structuredContent": {
          "content": "[FILE] package.json
[FILE] readme.txt
[DIR] src"
        }
      },
      "success": true
    },
    {
      "tool": "read_text_file",
      "request": {
        "name": "read_text_file",
        "arguments": {
          "path": "/private/tmp/pathfinder-test/readme.txt"
        }
      },
      "response": {
        "content": [
          {
            "type": "text",
            "text": "Hello from pathfinder test
"
          }
        ],
        "structuredContent": {
          "content": "Hello from pathfinder test
"
        }
      },
      "success": true
    },
    {
      "tool": "search_files",
      "request": {
        "name": "search_files",
        "arguments": {
          "path": "/private/tmp/pathfinder-test",
          "pattern": "**/*.js"
        }
      },
      "response": {
        "content": [
          {
            "type": "text",
            "text": "/private/tmp/pathfinder-test/src/index.js"
          }
        ],
        "structuredContent": {
          "content": "/private/tmp/pathfinder-test/src/index.js"
        }
      },
      "success": true
    },
    {
      "tool": "directory_tree",
      "request": {
        "name": "directory_tree",
        "arguments": {
          "path": "/private/tmp/pathfinder-test"
        }
      },
      "response": {
        "structuredContent": {
          "content": "[
  {"name":"package.json","type":"file"},
  {"name":"readme.txt","type":"file"},
  {"name":"src","type":"directory","children":[{"name":"index.js","type":"file"}]}
]"
        }
      },
      "success": true
    }
  ],
  "gotcha": "On macOS, /tmp symlinks to /private/tmp. The allowed-dir arg resolves to canonical path, but tool call paths must match literally. Always use /private/tmp."
}