关于 envibe
envibe-mcp 是 MCP 服务,为 AI 编码助手提供受权限控制的环境变量访问。五种访问级别规定 AI 可查看或修改的内容;初始化时会生成清单和筛选后的 .env.ai 文件,并阻止直接访问 .env。
主要功能
- 01五种变量访问级别
- 02列出并读取获准变量
- 03仅 full 权限可设置变量
- 04查看变量格式和示例
- 05检查缺失的必需变量
- 06阻止直接访问 .env
适用场景
- 01限制助手查看机密信息
- 02允许编辑指定环境变量
- 03引导配置必需变量
- 04提供配置格式提示
MCP 相关
envibe-mcp 提供列出、读取、设置和描述环境变量,以及检查必需变量的工具。AI 客户端可通过 MCP 配置连接。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
6收录的工具列表 · 更新于 2 周前
此工具无需参数。
详细介绍
envibe-mcp
envibe 的 MCP 服务——AI Agent 与你的 .env 之间缺失的权限层。
安装
添加到 AI 工具的 MCP 配置中:
{
"mcpServers": {
"envibe": {
"command": "npx",
"args": ["envibe-mcp"]
}
}
}
Claude Code
claude mcp add envibe npx envibe-mcp
Claude Desktop
添加到 claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
VS Code / Cursor / Windsurf
添加到编辑器的 MCP 设置中(详情请参阅主 envibe 文档)。
首次运行时,envibe 会自动:
- 根据
.env.example创建.env.manifest.yaml - 生成
.env.ai(供 AI 使用的筛选视图) - 阻止直接访问
.env文件
这是什么?
这是 envibe 的 MCP 服务组件。它让 AI 编码助手能够受控地访问环境变量,并提供 5 个访问级别:
| 级别 | AI 可以查看 | AI 可以修改 |
|---|---|---|
full | 实际值 | 可以 |
read-only | 实际值 | 不可以 |
placeholder | <VAR_NAME> | 不可以 |
schema-only | 仅格式 | 不可以 |
hidden | 无 | 不可以 |
MCP 工具
| 工具 | 说明 |
|---|---|
env_list | 列出可见变量及其访问级别 |
env_get | 获取变量的值(遵循权限设置) |
env_set | 设置变量(仅限 full 访问权限) |
env_describe | 获取详细信息,包括格式和示例 |
env_check_required | 检查缺少哪些必需变量 |
v0.2.0 功能
- 更完善的错误消息——访问被拒绝时,提供有用的指导
- 格式提示——了解变量应采用的格式(url、key、number 等)
- 必需变量检查——使用
env_check_required引导用户完成设置
面向命令行工具
如果你需要 envibe setup -i(交互模式)、envibe view 或 envibe generate 等命令行命令,请安装完整软件包:
npm install -g envibe
许可证
MIT
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。