Valide la sécurité, la structure et la conformité au runtime des packages de plugins Codex, des skills et des bundles de MCP server.
Aussi connu sous Esquetta/CodexPluginDoctor, codex-plugin-doctor
- Étoiles
- 2
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 7 nov. 2026
- Licence
- MIT
Qu'est-ce que CodexPluginDoctor MCP ?
Valide la sécurité, la structure et la conformité au runtime des packages de plugins Codex, des skills et des bundles de MCP server.
Résumé généré à partir du README du projet
À propos du MCP server CodexPluginDoctor
CodexPluginDoctor permet aux développeurs de valider la sécurité et la structure des packages de plugins Codex et des bundles de MCP server. Cet outil en ligne de commande inspecte les dossiers de plugins contenant un fichier .codex-plugin/plugin.json afin de s'assurer qu'ils respectent des exigences spécifiques avant le déploiement. Il recherche les secrets codés en dur, valide le câblage des skills et examine la qualité des métadonnées pour prévenir les erreurs de configuration courantes.
Les utilisateurs peuvent effectuer des inspections approfondies en utilisant le flag --runtime pour exécuter le code propre au package et vérifier le handshake MCP, ainsi que les tools, resources et prompts. Pour une sécurité accrue lors des tests d'exécution, l'option --sandbox docker isole les serveurs Node.js locaux via stdio. L'outil permet également de vérifier les plugins installés via la commande --installed et de confirmer la compatibilité avec des clients tels que Claude Desktop, Cursor, Cline et Windsurf.
Au-delà des vérifications locales, il offre la possibilité de comparer les outils et les modèles de ressources par rapport à une référence en utilisant des snapshots MCP. Il est conçu pour être intégré dans des workflows CI via GitHub Actions, permettant aux équipes d'automatiser les scorecards de sécurité et les rapports de conformité lors du processus de pull request.
Ce que vous pouvez faire avec
- 1Détecter les identifiants codés en durIdentifier si la configuration d'un MCP server contient des clés API sensibles qui devraient être remplacées par des références d'environnement.
- 2Vérifier la conformité au runtimeTester le MCP server en cours d'exécution pour s'assurer que les tools, resources et prompts fonctionnent conformément au protocole.
- 3Vérifier la compatibilité multi-clientsConfirmer qu'une configuration MCP est valide et prête à être utilisée dans différents clients IA desktop.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer CodexPluginDoctor MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller CodexPluginDoctor MCP dans Claude Code
$ claude mcp add codexplugindoctor -- npx -y codex-plugin-doctorInstaller CodexPluginDoctor MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"codexplugindoctor": {
"command": "npx",
"args": [
"-y",
"codex-plugin-doctor"
]
}
}
}Installer CodexPluginDoctor MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"codexplugindoctor": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codex-plugin-doctor"
]
}
}
}Installer CodexPluginDoctor MCP dans VS Code CLI
$ code --add-mcp '{"name":"codexplugindoctor","type":"stdio","command":"npx","args":["-y","codex-plugin-doctor"]}'Installer CodexPluginDoctor MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"codexplugindoctor": {
"command": "npx",
"args": [
"-y",
"codex-plugin-doctor"
]
}
}
}Installer CodexPluginDoctor MCP dans Codex
$ codex mcp add codexplugindoctor -- npx -y codex-plugin-doctorInstaller CodexPluginDoctor MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.codexplugindoctor] command = "npx" args = ["-y", "codex-plugin-doctor"]
Installer CodexPluginDoctor MCP dans Gemini CLI
$ gemini mcp add -s user codexplugindoctor npx -- -y codex-plugin-doctorInstaller CodexPluginDoctor MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"codexplugindoctor": {
"command": "npx",
"args": [
"-y",
"codex-plugin-doctor"
]
}
}
}Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleesquetta/codexplugindoctor is public and reachablegithub.com/esquetta/codexplugindoctor ↗Réussi
- Le nom du package correspond au dépôt sourcecodex-plugin-doctor names esquetta/codexplugindoctor as sourcenpmjs.com/package/codex-plugin-doctor ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for codex-plugin-doctornpmjs.com/package/codex-plugin-doctor/v/1.92.0#provenance ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-07github.com/esquetta/codexplugindoctor ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from codex-plugin-doctorRéussi
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubCodex Plugin Doctor
A CLI that checks Codex plugins, skills, and MCP servers before you ship them: the package, its security, and, if you allow it, the running MCP server.
npx codex-plugin-doctor check path/to/plugin
Point it at a folder with .codex-plugin/plugin.json. A plugin with an API key in its
.mcp.json exits with status 1 and this report (recommended commands trimmed):
Codex Plugin Doctor
===================
Status: FAIL
Target: /path/to/plugin
Summary: 1 fail, 0 warn, 1 total
Failures
--------
✖ plugin.security.hard_coded_secret
Message: The MCP server `dangerServer` contains a hard-coded secret-like env value for `OPENAI_API_KEY`.
Impact: Hard-coded credentials inside plugin bundles increase leakage risk and make secure rotation difficult.
Suggested fix: Replace the literal value for `OPENAI_API_KEY` with an environment reference or injected secret outside the package.
Fingerprint: 21da7c75027f0811929d49253412a0f20694d974f141d0421410c89ee29c8b72
Evidence: serverName=dangerServer, configPath=.mcp.json, envKey=OPENAI_API_KEY, envValue=[REDACTED]
Add --runtime to also start the plugin's MCP servers and call them. That runs the
package's own code, so it is opt-in, and --sandbox docker isolates local Node.js stdio
servers. No plugin at hand? npx codex-plugin-doctor check --installed checks the ones
in your Codex plugin cache.
What It Checks
- Package:
.codex-plugin/plugin.json, skill wiring andSKILL.mdmetadata,.mcp.jsonstructure, description quality, hard-coded secrets, and paths that escape the package. - Security (
security .): a scorecard for shell wrappers, encoded commands, remote content piped into a shell, and plain HTTP transports. - Running servers (
--runtime): the MCP handshake, then tools, resources, prompts, and pagination, with a scorecard and a conformance report. - Breaking changes: MCP snapshots compare tools, prompts, and resource templates with a committed baseline, in a pull request comment and in release notes.
- Other clients (
compat . --all --scorecard): whether the MCP config is valid and can be added to Claude Desktop, Cursor, Cline, and Windsurf on this machine. - Remote servers and publishing: opt-in Remote MCP Readiness, MCP Registry Readiness, and an offline public directory preflight.
See the CLI Reference for more commands and examples,
codex-plugin-doctor --help for all of them, and codex-plugin-doctor explain <finding-id> for
what a rule means.
Install
npm install -g codex-plugin-doctor
codex-plugin-doctor self-test
codex-plugin-doctor check .
codex-plugin-doctor check . --runtime
codex-plugin-doctor mcp path/to/mcp-package
GitHub Action
name: Validate Codex plugin
on:
pull_request:
permissions:
contents: read
jobs:
doctor:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
with:
persist-credentials: false
- uses: Esquetta/CodexPluginDoctor@v1.92.0
with:
version: "1.92.0"
path: .
runtime: "true"
policy: codex-publish
runtime: "true" runs the package's code, so this job keeps a read-only token.
codex-plugin-doctor init-ci . writes a workflow for you. See
GitHub Action Usage for reports, pull request comments, and
inputs.
Documentation
- CLI Reference
- GitHub Action Usage
- MCP Snapshot
- Release Gating
- Rule Catalog
- Official Plugin Components
- Real-World Validation
- Examples
- Changelog
- All documentation
1.0 Stability
The 1.0 line is the stable compatibility baseline for plugin authors and CI consumers.
- Public JSON schema surfaces and existing rule IDs/default severities are treated as stable through 1.0.
- Runtime probing remains opt-in because it executes package-local MCP servers.
- New features stay additive unless a major version says otherwise.
See the documentation index for architecture, usage, security, and contributor guides.
Contributing
Contributions are welcome. Start with Contributing, the
Security Policy, the Code of Conduct, and the
validation tuning issue template.
npm run release-check runs the release preflight; see
Versioning and Releases.
Support
If this tool saves you time, GitHub stars and sponsorship help signal that the project is worth continuing.
- Star the repository on GitHub.
- Use GitHub Sponsors through the repository funding link.
- Open validation tuning issues for false positives or false negatives.
Questions sur CodexPluginDoctor MCP
Comment ajouter CodexPluginDoctor MCP à Claude Code ?
Exécutez claude mcp add codexplugindoctor -- npx -y codex-plugin-doctor dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter CodexPluginDoctor MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Comment puis-je vérifier si un MCP server contient des secrets codés en dur ?
L'outil recherche automatiquement les secrets codés en dur, tels que les clés API, dans le fichier .mcp.json et s'arrêtera avec un statut d'échec si des éléments sont détectés.
Puis-je tester le MCP server en cours d'exécution avec cet outil ?
Oui, en ajoutant le flag --runtime, l'outil démarrera les MCP servers du plugin et appellera ses tools, resources et prompts pour vérifier la conformité.
Comment puis-je isoler les MCP servers en cours d'exécution pendant les tests ?
Vous pouvez utiliser le flag --sandbox docker pour isoler les serveurs Node.js locaux via stdio.
Puis-je utiliser cet outil pour vérifier les plugins déjà installés dans mon cache ?
Oui, l'exécution de npx codex-plugin-doctor check --installed permet de vérifier les plugins présents dans votre cache de plugins Codex.