Skip to main content
ClaudeWave
Skill79 repo starsupdated yesterday

mcp-check

The mcp-check skill validates a project's MCP server configuration by examining JSON files, verifying required settings like mcpServers object and enableAllProjectMcpServers flag, checking individual MCP command validity and environment variables, identifying missing recommended MCPs, and detecting security issues like hardcoded secrets. Use this skill when setting up Claude Code projects, troubleshooting MCP integration problems, or ensuring configuration completeness before deployment.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/claude-world/director-mode-lite /tmp/mcp-check && cp -r /tmp/mcp-check/skills/mcp-check ~/.claude/skills/mcp-check
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# MCP Configuration Validator

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

---

## Validation Steps

### 1. Check Configuration Files
- `.claude/settings.json` (project)
- `~/.claude.json` (user, reference)

### 2. Validate Structure
- [ ] Valid JSON format
- [ ] `mcpServers` object exists
- [ ] `enableAllProjectMcpServers: true` is set

### 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

```markdown
## 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` |