Skip to content

docs(filesystem): clarify read_multiple_files input - #4504

Closed
Joosboy wants to merge 1 commit into
modelcontextprotocol:mainfrom
Joosboy:docs-filesystem-read-multiple-files
Closed

Joosboy wants to merge 1 commit into
modelcontextprotocol:mainfrom
Joosboy:docs-filesystem-read-multiple-files

Conversation

@Joosboy

@Joosboy Joosboy commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Clarify that read_multiple_files expects a non-empty paths array.
  • Document that each path must be within the allowed directories.
  • Note that returned file contents are separated by path references and ---.

Why

Issue #2032 reports that the read_multiple_files argument shape and behavior were not clear enough from the filesystem server docs. The tool schema already enforces a non-empty array, so this updates the README to match the current schema and output behavior.

Validation

  • git diff --check
  • npm run build --workspace @modelcontextprotocol/server-filesystem

Related issue

Refs #2032

@cliffhall cliffhall added the closed-superseded-v2 Closed: fixed or made obsolete by the v2 / 2026-07-28 refactor (#4875) label Oct 20, 2026
@cliffhall

Copy link
Copy Markdown
Member

Thank you for this pull request, and apologies for the long wait for a response.

Since it was opened, the reference servers have been rebuilt for the 2026-07-28 MCP specification (#4857) and released as v2 (2.0.0 on npm for the TypeScript servers, 2026.10.19 on PyPI for the Python servers). The code this PR changes has been replaced, and the behavior it addresses has either been fixed in v2 or no longer exists in the same form.

This is not a judgment on the change or on you; it's a consequence of the code it targets having been replaced. If the problem still happens on v2, please open a fresh issue with the version you're running and steps to reproduce. Note that this repository now accepts contributions as issues rather than pull requests from anyone but its maintainers; see CONTRIBUTING.md.

This is part of the backlog triage in #4875.

@cliffhall cliffhall closed this Oct 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

closed-superseded-v2 Closed: fixed or made obsolete by the v2 / 2026-07-28 refactor (#4875)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants