MCP local configuration (.mcp.json) not being read on Windows
Issue Description
Claude Code does not read or load MCP server configurations from local .mcp.json files on Windows systems.
Environment
- OS: Windows
- Claude Code Version: Latest
- Reporter: scopweb
Expected Behavior
When a .mcp.json file exists in the project root, Claude Code should automatically read and load the MCP server configurations defined in it.
Actual Behavior
The .mcp.json configuration file is completely ignored. Running claude mcp list shows "No MCP servers configured" even though a valid .mcp.json file exists in the project directory with properly configured MCP servers.
Steps to Reproduce
- Create a
.mcp.jsonfile in the project root:
{
"mcpServers": {
"mysql-server": {
"command": "C:\tools\mcp-servers\mysql-mcp.exe",
"args": [],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "dbuser",
"MYSQL_PASSWORD": "dbpass",
"MYSQL_DATABASE": "mydb"
}
}
}
}
- Open Claude Code in that project directory
- Run
claude mcp list - Result: "No MCP servers configured"
Workaround
Must manually add servers using CLI:
claude mcp add mysql-server "C:\tools\mcp-servers\mysql-mcp.exe" --env MYSQL_HOST=localhost ...
Impact
Users cannot use project-specific MCP configurations on Windows, forcing them to configure servers globally or manually each session.
Request
Please fix the .mcp.json file reading functionality on Windows so that local MCP configurations work as expected.
---
Reported by: scopweb
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗