read_multiple_files
Read multiple UTF-8 text files simultaneously and return their contents as a path-to-content mapping. This tool enables batch file reading operations within allowed directory boundaries.
Instructions
Read multiple UTF-8 text files at once and return a mapping of paths to contents.
Args: paths (List[str]): List of file paths to read (absolute or relative to allowed directories)
Returns: Dict[str, str] | str: Dictionary mapping absolute file paths to their contents, or error message if any file fails
Note: - All paths must be within allowed directory roots - All files must be UTF-8 text files - If any file fails to read, entire operation returns error string - Returns dictionary for successful reads, string for errors
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paths | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- main.py:433-459 (handler)The handler function for the 'read_multiple_files' MCP tool. It reads the contents of multiple specified UTF-8 text files within allowed directories, returning a dictionary mapping absolute paths to file contents or an error string if any issue occurs. Registered via @mcp.tool decorator.
@mcp.tool def read_multiple_files(paths: List[str]) -> Dict[str, str] | str: """Read multiple UTF-8 text files at once and return a mapping of paths to contents. Args: paths (List[str]): List of file paths to read (absolute or relative to allowed directories) Returns: Dict[str, str] | str: Dictionary mapping absolute file paths to their contents, or error message if any file fails Note: - All paths must be within allowed directory roots - All files must be UTF-8 text files - If any file fails to read, entire operation returns error string - Returns dictionary for successful reads, string for errors """ result: Dict[str, str] = {} try: for p in paths: rp = _resolve(p) if not _is_text(rp): return f"Error reading multiple files: '{rp}' is not a UTF-8 text file or is binary" result[str(rp)] = rp.read_text(encoding="utf-8") return result except Exception as e: return _human_error(e, "reading multiple files")