MCP server secure-api
Коммит 12 нояб. 2026 г.Внедряет секреты в команды и API-вызовы во время выполнения, одновременно очищая вывод, чтобы предотвратить утечку конфиденциальных данных в AI-клиенты.
Также известен как than/secure-api-mcp
- Звёзды
- 5
- Инструменты
- 5
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 12 нояб. 2026 г.
- Лицензия
- —
Что такое secure-api MCP?
Внедряет секреты в команды и API-вызовы во время выполнения, одновременно очищая вывод, чтобы предотвратить утечку конфиденциальных данных в AI-клиенты. Он предоставляет 5 инструментов, например get_env_keys, run_with_env, api_call.
Сводка сгенерирована из README проекта
О secure-api MCP server
Этот сервер позволяет защитить конфиденциальные учетные данные от кэширования или чтения такими AI-клиентами, как Claude Code. Он дает разработчикам возможность предоставить AI-агенту доступ к переменным окружения и конфигурационным файлам, не раскрывая при этом реальные значения секретов в контексте диалога. Внедряя секреты в команды и HTTP-запросы во время выполнения и затем редактируя полученный вывод, сервер создает уровень безопасности между вашими приватными ключами и LLM.
Пользователи могут управлять секретами с помощью специальных инструментов, таких как api_call для структурированных HTTP-запросов и run_with_env для выполнения shell-команд. Сервер также обрабатывает учетные данные MySQL через read_mycnf и помогает поддерживать документацию с помощью sync_env_example. Для обеспечения безопасности инструмент api_call включает защиту от SSRF и поддерживает белый список хостов через переменную окружения SECURE_API_ALLOWED_HOSTS. Эта конфигурация предназначена для локальных сред разработки, где разработчики хотят использовать Claude Code, предотвращая скрытое сохранение секретов в открытом виде в истории файлов.
Что вы можете с ним делать
- 1Выполнение shell-команд с секретамиЗапуск терминальных команд, требующих переменные окружения, без возможности AI увидеть их значения в выводе.
- 2Выполнение безопасных API-запросовВыполнение HTTP-вызовов, включающих Bearer-токены или пользовательские заголовки, с проверкой авторизации целевого хоста.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Инструменты secure-api MCP 5
Определено из READMEget_env_keysrun_with_envapi_callread_mycnfsync_env_example
| get_env_keys | — | |
| run_with_env | — | |
| api_call | — | |
| read_mycnf | — | |
| sync_env_example | — |
Конфигурация
SECURE_API_ALLOWED_HOSTS
| Название | Описание | Тип |
|---|---|---|
| SECURE_API_ALLOWED_HOSTS | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийthan/secure-api-mcp is public and reachablegithub.com/than/secure-api-mcp ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)No licenseПроблема
- Коммит или релиз за последний годLast commit or release 2026-11-12github.com/than/secure-api-mcp ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыNo tool named like delete, drop or execПройдено
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на 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
Вопросы о secure-api MCP
Какие инструменты предоставляет secure-api MCP?
Он предоставляет 5 инструментов, включая get_env_keys, run_with_env, api_call, read_mycnf, sync_env_example.
Как сервер защищает мои секреты от просмотра Claude?
Сервер внедряет секреты в команды и API-вызовы непосредственно во время выполнения, а затем очищает вывод, удаляя значения секретов до того, как они попадут в контекст AI.
Гарантируется ли очистка вывода shell-команд?
Нет, очистка вывода shell-команд выполняется по принципу best-effort. Команда может перекодировать или преобразовать секрет так, что очиститель его не распознает.
Могу ли я ограничить хосты, на которые инструмент api_call может отправлять секреты?
Да, вы можете установить переменную окружения SECURE_API_ALLOWED_HOSTS в виде списка разрешенных хостов через запятую, чтобы контролировать запросы, в которые внедряются секреты.