convez.ai
MCP Server
MukundaKatta

mcp-config-check

MukundaKatta/mcp-config-check

Ver no GitHub
InicialPluginScore · de 0 a 100

Linter for MCP (Model Context Protocol) config files. Python, CLI + library. Supports Claude Desktop, Cursor, Cline, Windsurf, Zed.

Instalação

$npx convez-ai MukundaKatta/mcp-config-check

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
v0.1.0
Issues abertas
4
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

mcp-config-check

CI PyPI Python License: MIT

A small Python linter for Model Context Protocol config files used by Claude Desktop, Cursor, Cline, Windsurf, and Zed.

It catches common footguns before you start a broken MCP server:

  • missing or conflicting transport (no command and no url, or both set)
  • malformed command / args / env shapes
  • hardcoded API keys in env or args (Anthropic, OpenAI, AWS, GitHub, Stripe, Slack, Google, HuggingFace, and more)
  • placeholder values left in ("<your-api-key>", "replace-me", etc.)
  • URLs with embedded credentials (https://user:pass@...)
  • auth headers sent over plain HTTP
  • autoApprove: ["*"] / alwaysAllow: ["*"] wildcards that silently disable tool confirmation
  • case-insensitive duplicate server names
  • unknown fields in a server entry

Supports both the Claude/Cursor/Cline/Windsurf shape (mcpServers) and the Zed shape (context_servers).

Install

pip install mcp-config-check

Usage

mcp-config-check path/to/mcp.json

Multiple files:

mcp-config-check ~/Library/Application\ Support/Claude/claude_desktop_config.json ~/.cursor/mcp.json

Only show errors (no OK lines, no warnings):

mcp-config-check --quiet path/to/mcp.json

Exit status: 0 on no errors, 1 on any errors.

Use as a library

from mcp_config_check import validate_config_file

result = validate_config_file("path/to/mcp.json")
if not result.ok:
    for issue in result.errors:
        print(issue.code, issue.server, issue.message)

Issue codes

CodeSeverityMeaning
E000errorfile-level problem (missing, empty, not JSON, wrong root shape)
E001errorserver has no transport (command or url required)
E002errorserver declares both command and url
E003errorcommand is not a non-empty string
E004errorargs is not an array of strings
E005errorhardcoded secret detected in args
E006errorenv is not a string-valued object
E007errorhardcoded secret detected in env value
E008errorenv value is an obvious placeholder
E020errorurl is invalid or has a non-http(s) scheme
E021errorurl has embedded credentials
E022errorAuthorization header sent over plain HTTP
E030errorno mcpServers or context_servers container found
E031errorcase-insensitive duplicate server name
E100errorautoApprove / alwaysAllow contains "*"
W030warningserver container is empty
W900warningunknown field on a server entry

Use as a GitHub Action

Add this step to any workflow:

- uses: actions/checkout@v5
- uses: MukundaKatta/mcp-config-check@v1
  with:
    paths: .mcp.json

Pass multiple files space-separated (e.g. paths: .mcp.json .cursor/mcp.json). The action runs the same checks as the CLI and fails the workflow on any errors. Inputs: paths (required), quiet (default false), python-version (default 3.12).

Development

pip install -e '.[dev]'
pytest

License

MIT

Ver o original no GitHub

Bom para

Relacionados