MCP server de secure-api
Commit 12 nov 2026Inyecta secretos en comandos y llamadas a API en tiempo de ejecución mientras sanitiza las salidas para evitar la exposición de datos sensibles a clientes de IA.
También conocido como than/secure-api-mcp
- Stars
- 5
- Herramientas
- 5
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 12 nov 2026
- Licencia
- —
¿Qué es secure-api MCP?
Inyecta secretos en comandos y llamadas a API en tiempo de ejecución mientras sanitiza las salidas para evitar la exposición de datos sensibles a clientes de IA. Expone 5 herramientas, como get_env_keys, run_with_env, api_call.
Resumen generado a partir del README del proyecto
Acerca del MCP server de secure-api
Este servidor permite proteger credenciales sensibles para que no sean almacenadas en caché o leídas por clientes de IA como Claude Code. Permite a los desarrolladores dotar a un agente de IA de la capacidad de usar variables de entorno y archivos de configuración sin exponer nunca los valores reales de los secretos en el contexto de la conversación. Al inyectar secretos en comandos y peticiones HTTP en tiempo de ejecución y luego redactar la salida resultante, mantiene una capa de seguridad entre tus claves privadas y el LLM.
Los usuarios pueden gestionar secretos mediante herramientas específicas como api_call para peticiones HTTP estructuradas y run_with_env para ejecutar comandos de shell. El servidor también gestiona credenciales de MySQL a través de read_mycnf y ayuda a mantener la documentación usando sync_env_example. Para garantizar la seguridad, la herramienta api_call incluye protección contra SSRF y admite una lista de permitidos de hosts mediante la variable de entorno SECURE_API_ALLOWED_HOSTS. Esta configuración está pensada para entornos de desarrollo local donde los desarrolladores quieren usar Claude Code evitando el almacenamiento silencioso de secretos en texto plano en el historial de archivos.
Qué puedes hacer con él
- 1Ejecutar comandos de shell con secretosEjecuta un comando de terminal que requiere variables de entorno sin permitir que la IA vea los valores en la salida.
- 2Realizar peticiones API segurasRealiza llamadas HTTP que incluyan tokens Bearer o encabezados personalizados asegurando que el destino esté autorizado.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de secure-api MCP 5
Detectado desde el READMEget_env_keysrun_with_envapi_callread_mycnfsync_env_example
| get_env_keys | — | |
| run_with_env | — | |
| api_call | — | |
| read_mycnf | — | |
| sync_env_example | — |
Configuración
SECURE_API_ALLOWED_HOSTS
| Nombre | Descripción | Tipo |
|---|---|---|
| SECURE_API_ALLOWED_HOSTS | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblethan/secure-api-mcp is public and reachablegithub.com/than/secure-api-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)No licenseHallazgo
- Commit o lanzamiento en el último añoLast commit or release 2026-11-12github.com/than/secure-api-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubsecure-api-mcp
MCP server that lets Claude Code use secrets without seeing them.
Claude Code silently reads .env files and caches them in plaintext in ~/.claude/file-history/. This server injects secrets into commands and API calls at runtime, then sanitizes output to strip secret values before they reach Claude's context.
Threat model — read this. The strength of the guard differs by tool:
api_callhas the smallest attack surface: no shell, structured output, SSRF protection, and an optional destination allowlist (see below). Sanitization reliably covers its responses.run_with_envruns an arbitrary shell command. Output sanitization is best-effort, not a hard boundary — a command can re-encode, reverse, chunk, or otherwise transform a secret into a form the sanitizer won't recognize before printing it. Treat it as defense-in-depth.
A secret can only be protected if you control where it goes. Both tools can send a secret to an external destination by design; restrict that with deny rules, the api_call allowlist, and review of run_with_env commands.
Tools
get_env_keys(project_dir)— Returns key names from.env. No values exposed.run_with_env(project_dir, command, env_keys?, timeout_ms?, include_mycnf?)— Runs a shell command with.envvars injected. Output is sanitized — secret values replaced with[REDACTED:KEY_NAME]. Setinclude_mycnfto also sanitize MySQL credentials from.my.cnfin command output.api_call(project_dir, url, method?, headers?, body?, auth_env_key?, timeout_ms?)— HTTP request with secret injection.auth_env_keyadds a Bearer token. Headers support{{KEY_NAME}}template syntax. When a secret is injected, the destination host is checked againstSECURE_API_ALLOWED_HOSTS(see below). Redirects are followed manually, up to 5 hops, with the SSRF guard and the allowlist re-applied to every hop. Times out aftertimeout_ms(default 30s).read_mycnf(project_dir, section?)— Reads MySQL.my.cnfconfiguration. Returns section names and safe fields (port,database,socket) with credentials (user,password,host) redacted as[REDACTED:section.field]. Checks~/.my.cnfand project-local.my.cnf.sync_env_example(project_dir)— Generates/updates.env.examplefrom.env. Preserves comments and structure, strips values, uses smart placeholders.
Setup
npm install && npm run build
Register in Claude Code:
claude mcp add secure-api -- node /path/to/secure-api-mcp/dist/index.js
Pair with deny rules in ~/.claude/settings.json to block direct .env reads:
"deny": [
"Read(.env)", "Read(**/.env)",
"Read(.env.local)", "Read(**/.env.local)",
"Edit(.env)", "Edit(**/.env)"
]
Keeping .env.example in sync
Run sync_env_example to generate or update .env.example from your .env. It:
- Preserves comments and blank lines from
.env - Strips secret values, replacing them with smart placeholders (URLs stay URL-shaped, booleans stay as-is, numbers stay as-is, everything else blanked)
- Merges with any existing
.env.example— custom placeholders you've added won't be overwritten - Lets Claude read
.env.examplefreely (since deny rules only block.env) so it knows what config exists without seeing values
Pair this with get_env_keys and Claude has full awareness of your project's config without any secret exposure.
Restricting where api_call can send secrets
By default api_call will attach a secret to a request bound for any public host (internal/private IPs are always blocked for SSRF). To restrict this, set SECURE_API_ALLOWED_HOSTS to a comma-separated list of permitted hosts:
export SECURE_API_ALLOWED_HOSTS="api.stripe.com,api.github.com,*.internal.example.com"
- Set — a request that injects a secret is blocked unless its host matches.
*.example.commatches any subdomain and the apexexample.com. Matching is case-insensitive. - Unset — secrets are still sent (so existing setups keep working), but the response includes a
warningsentry naming the destination host.
Requests that inject no secret are never gated.
MySQL .my.cnf support
Claude can work with MySQL configs without seeing your credentials. read_mycnf exposes structural fields (port, database, socket) while redacting user, password, and host. When running MySQL commands via run_with_env, set include_mycnf: true to sanitize any credential values that appear in command output — the mysql CLI reads ~/.my.cnf natively, so no env var injection is needed.
Resolution order matches MySQL's own: ~/.my.cnf (global), then <project_dir>/.my.cnf (project-local overrides global per-field). !include and !includedir directives are followed. Includes in the project-local chain are contained to the project directory (resolved through symlinks) so a crafted project .my.cnf can't disclose files elsewhere on disk; the trusted global ~/.my.cnf chain is unrestricted.
How sanitization works
Secret values of 4 or more characters are replaced in all output, sorted longest-first to prevent partial matches. A value like sk-abc123xyz becomes [REDACTED:API_KEY]. The literal value, its base64 form, and its URL-encoded form are all matched, followed by a pattern pass for common token shapes (AWS, GitHub, Stripe, Slack, JWTs, private keys). Values transformed in other ways (hex, reversed, split across lines) are not caught — this is why run_with_env output is best-effort, not a guarantee.
License
MIT
Preguntas sobre secure-api MCP
¿Qué herramientas proporciona secure-api MCP?
Expone 5 herramientas, incluidas get_env_keys, run_with_env, api_call, read_mycnf, sync_env_example.
¿Cómo protege el servidor mis secretos para que Claude no los vea?
El servidor inyecta los secretos en los comandos y llamadas a API en tiempo de ejecución y luego sanitiza la salida para eliminar los valores de los secretos antes de que lleguen al contexto de la IA.
¿Está garantizada la sanitización de la salida de comandos de shell?
No, la sanitización de comandos de shell es un proceso de mejor esfuerzo. Un comando podría potencialmente re-codificar o transformar un secreto de modo que el sanitizador no lo reconozca.
¿Puedo restringir a qué hosts puede enviar secretos la herramienta api_call?
Sí, puedes configurar la variable de entorno SECURE_API_ALLOWED_HOSTS con una lista separada por comas de los hosts permitidos para controlar las solicitudes que inyectan secretos.