Skip to content
cccskills
FreePublished on GitHub

mcp-check

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

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (1)

  • SKILL.md2.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

MCP Configuration Validator

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


Validation Steps

1. Check Configuration Files

FileScopeWhat lives here
.mcp.json (project root)ProjectmcpServers — the server definitions, written by claude mcp add --scope project
.claude/settings.jsonProjectToggles only: enableAllProjectMcpServers, enabledMcpjsonServers
~/.claude.jsonUserUser-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

MCPRequired?
memoryRecommended
filesystemOptional
githubIf .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

IssueFix
Invalid JSONCheck trailing commas
MCP not loadingclaude mcp reset-project-choices
Missing env varsAdd with -e KEY=value

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Validate custom agent file format and structure. Use after creating or editing an agent, before committing agent changes, or when an agent fails to load.

The English summary is being prepared. Showing the original description.

claude-world/director-mode-lite80Updated Oct 21, 2026

Generate custom agent from template. Use when creating a new subagent from scratch, or scaffolding an agent file with correct frontmatter.

The English summary is being prepared. Showing the original description.

claude-world/director-mode-lite80Updated Oct 21, 2026

agents

Free

List all available agents (core, expert, self-evolving). Use when the user asks what agents are available or runs /agents.

The English summary is being prepared. Showing the original description.

claude-world/director-mode-lite80Updated Oct 21, 2026

TDD-based autonomous development loop with checkpoint recovery and observability changelog

The English summary is being prepared. Showing the original description.

claude-world/director-mode-lite80Updated Oct 21, 2026

View and manage the runtime changelog for observability

The English summary is being prepared. Showing the original description.

claude-world/director-mode-lite80Updated Oct 21, 2026

Track development session events in a daily markdown changelog, including file changes, test results, and key decisions.

The English summary is being prepared. Showing the original description.

claude-world/director-mode-lite80Updated Oct 21, 2026

See all skills by claude-world

Report a problem with this skill