mcp-check

name	mcp-check
description	Validate MCP configuration and suggest improvements. Use when MCP servers fail to load, after editing .mcp.json, or when the user runs /mcp-check.
user-invocable	true

MCP Configuration Validator

Validate the project's MCP setup for correctness and completeness.

---

Validation Steps

1. Check Configuration Files

File	Scope	What lives here
.mcp.json (project root)	Project	mcpServers — the server definitions, written by claude mcp add --scope project
.claude/settings.json	Project	Toggles only: enableAllProjectMcpServers, enabledMcpjsonServers
~/.claude.json	User	User-scope mcpServers, available across all projects

The source of truth for project servers is .mcp.json at the project root. Read mcpServers from there — .claude/settings.json never holds server definitions, only approval toggles.

2. Validate Structure

• .mcp.json is valid JSON (no trailing commas)
• mcpServers object exists in .mcp.json
• Project servers are approved via .claude/settings.json: either enableAllProjectMcpServers: true, or each server named in enabledMcpjsonServers

3. Validate Each MCP

• command is valid
• args properly formatted
• env variables set

4. Check Essential MCPs

MCP	Required?
memory	Recommended
filesystem	Optional
github	If .git exists

5. Security Check

• No hardcoded secrets
• Sensitive values use env vars

---

Output Format

## MCP Configuration Report

### Status: VALID / ISSUES / INVALID

### Configuration Summary
| MCP Server | Status | Notes |
|------------|--------|-------|
| memory | OK/FAIL | details |

### Issues Found
1. [Issue and fix]

### Missing Recommended MCPs
- memory: `claude mcp add --scope project memory...`

---

Common Issues

Issue	Fix
Invalid JSON	Check trailing commas
MCP not loading	claude mcp reset-project-choices
Missing env vars	Add with -e KEY=value