# MCP server config linter and doctor

Checks .mcp.json and claude_desktop_config files for missing binaries, bad env vars, duplicate server names and unreachable endpoints, then shows how to fix each one. For anyone whose MCP servers silently fail to load.

## Validation Rules

This tool performs four validation checks on your MCP server configuration:

1. **Duplicate server detection**: Ensures that each server has a unique name in the configuration.
2. **Binary existence**: Checks that the binary specified for each server exists in the system PATH or is an absolute path.
3. **Env var validation**: Validates that environment variables are defined and have appropriate values (if required).
4. **Endpoint reachability**: For servers that specify an endpoint (e.g., HTTP), checks that the endpoint is reachable.

## Installation

```bash
pip install -e ".[dev]"
```

Requires Python >=3.11

## Usage

TODO: fill in as the build loop lands the core feature.

## Example

TODO.

## FAQ

**What if a binary is optional?**
If a binary is optional, you can mark it as such in the configuration by setting `"optional": true` for that server. The linter will skip the binary existence check for optional servers.

**How to ignore a server?**
To ignore a server during validation, add `"ignore": true` to the server's configuration. The linter will skip all checks for that server.

## License

MIT -- see [LICENSE](LICENSE).