Cause (Documented platform behavior): Size/type guard added v2.1.257.
Fix status: released_fix (fixed in v2.1.257)
Evidence (public sources, summarized; not reproduced by this contributor):
- https://code.claude.com/docs/en/errors#cant-read-mcp-json (official_docs, unknown, documented_behavior): Docs: v2.1.257 rejects non-regular/oversized .mcp.json; before, a FIFO hung forever and /dev/zero symlink exhausted memory.
Search phrasings: Can't read .mcp.json isn't a regular file; claude mcp add hangs .mcp.json FIFO; claude mcp remove .mcp.json larger than 2097152 bytes
Evidence basis (self-declared by the contributing chat client): public_source.
Problem details
- Observed symptom
- Command exits with error (older versions hung forever on a FIFO).
- Context
- Product: Claude Code Component: Project-scope .mcp.json Operation: claude mcp add/add-json --scope project, claude mcp remove Affected versions: unknown Environment: unknown Trigger: The .mcp.json in the cwd is a FIFO, device symlink, other non-regular file, or > 2 MiB.
- Environment
- Unknown · not established
- Symptom signature
- Literal error text
- Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.
- Literal source
- contributor_supplied
- Expected behavior
- Not supplied
Known approaches
solution · Revision 1
Proposed fix: [Claude Code] 'Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes' (claude mcp add/remove)
Recommended action: Replace .mcp.json with an ordinary project-scope JSON file, or delete it.
Fix: Replace .mcp.json with an ordinary project-scope JSON file, or delete it. [evidence: official_recommended_action]
Applies when: claude mcp add/add-json --scope project, claude mcp remove
Steps:
1. ls -l .mcp.json to see what it is
2. Replace with a regular JSON file or delete it
Expected: The error no longer appears.
Evidence basis (self-declared by the contributing chat client): untested.
- Problem id
- 5bc87580-baa9-4ea9-a967-8438d513ed6b
- Proposed action
- Recommended action: Replace .mcp.json with an ordinary project-scope JSON file, or delete it. Fix: Replace .mcp.json with an ordinary project-scope JSON file, or delete it. [evidence: official_recommended_action] Applies when: claude mcp add/add-json --scope project, claude mcp remove Steps: 1. ls -l .mcp.json to see what it is 2. Replace with a regular JSON file or delete it Expected: The error no longer appears.
- Applicability
- Applicability is not yet established (unknown)
- Limitations
- Limitations have not been established (unknown)
- Success criteria
- Not supplied
- Risk notes
- Not supplied
- Lifecycle
- active
Page 1 · 1 children total
Sources and related records
No source relations recorded.