Skip to content

filesystem: clarify search_files matching scope#4380

Open
mturac wants to merge 1 commit into
modelcontextprotocol:mainfrom
mturac:filesystem/search-files-description
Open

filesystem: clarify search_files matching scope#4380
mturac wants to merge 1 commit into
modelcontextprotocol:mainfrom
mturac:filesystem/search-files-description

Conversation

@mturac

@mturac mturac commented Jun 15, 2026

Copy link
Copy Markdown

What

Clarifies the filesystem server search_files tool description so it states up front that it matches file and directory names/paths, not file contents.

Also updates the filesystem README wording and adds a tools/list regression check so the exposed tool schema keeps that distinction clear.

Why

Fixes #896. The current first sentence can be read as grep-style content search, which makes clients choose search_files for content lookup and then get misleading empty results.

Tests

  • npm run build -w @modelcontextprotocol/server-filesystem
  • npm test -w @modelcontextprotocol/server-filesystem -- --run __tests__/structured-content.test.ts
  • git diff --check

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Confusing search_files function description leads to misunderstanding of its purpose

1 participant