io.github.dominic-righthere/envibe

Name: io.github.dominic-righthere/envibe
Author: dominic-righthere

编码与调试

by dominic-righthere

在 AI agents 与你的 .env 文件之间提供安全的权限层，帮助控制敏感环境变量的访问。

GitHub

什么是 io.github.dominic-righthere/envibe？

在 AI agents 与你的 .env 文件之间提供安全的权限层，帮助控制敏感环境变量的访问。

README

envibe-mcp

MCP server for envibe - the missing permission layer between AI agents and your .env.

Install

Add to your AI tool's MCP config:

json

{
  "mcpServers": {
    "envibe": {
      "command": "npx",
      "args": ["envibe-mcp"]
    }
  }
}

<details> <summary>Claude Code</summary>

bash

claude mcp add envibe npx envibe-mcp

</details> <details> <summary>Claude Desktop</summary>

Add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

</details> <details> <summary>VS Code / Cursor / Windsurf</summary>

Add to your editor's MCP settings (see main envibe docs for details).

</details>

On first run, envibe automatically:

Creates .env.manifest.yaml from your .env.example
Generates .env.ai (filtered view for AI)
Blocks direct .env file access

What is this?

This is the MCP server component of envibe. It gives AI coding assistants controlled access to your environment variables with 5 access levels:

Level	AI Can See	AI Can Modify
`full`	Actual value	Yes
`read-only`	Actual value	No
`placeholder`	`<VAR_NAME>`	No
`schema-only`	Format only	No
`hidden`	Nothing	No

MCP Tools

Tool	Description
`env_list`	List visible variables with access levels
`env_get`	Get a variable's value (respects permissions)
`env_set`	Set a variable (only `full` access)
`env_describe`	Get detailed info including format and example
`env_check_required`	Check which required variables are missing

v0.2.0 Features

Better error messages - When access is denied, get helpful guidance
Format hints - Know what format a variable should be (url, key, number, etc.)
Required var checking - Use env_check_required to guide users through setup

For CLI tools

If you need CLI commands like envibe setup -i (interactive mode), envibe view, or envibe generate, install the full package:

bash

npm install -g envibe

License

MIT

常见问题