Content
# Read Complete Files MCP Server
A simple MCP server that reads complete files without token limits, designed to overcome Claude Code's default 25k token read limit.
## Installation
Add the MCP server to Claude Code with user scope:
```bash
claude mcp add --scope user read-complete -- node <path-to-repo>/index.js
```
## Configuration for Large Files
For optimal performance when reading large files:
### 1. Use 1M Context Model
Run `/model` in Claude Code and select the 1M context window version of Sonnet (e.g., `sonnet[1m]`).
### 2. Increase Output Limits
Set limits to handle large files. Add these to your `~/.claude/settings.json`:
```json
{
"env": {
"MAX_MCP_OUTPUT_TOKENS": "500000",
"BASH_MAX_OUTPUT_LENGTH": "100000",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "100000"
}
}
```
Or use the command line:
```bash
export MAX_MCP_OUTPUT_TOKENS=500000
export BASH_MAX_OUTPUT_LENGTH=100000
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=100000
```
Restart Claude Code after making these changes.
## Tools Available
- **`read_complete_file`** - Read complete file contents without token limits
- **`read_multiple_complete_files`** - Read multiple complete files simultaneously
These tools are automatically preferred when:
- A user specifically requests to read files
- Default read tools fail due to size limits
- Reading documentation or large config files