mcpField
E
envibe

envibe

本地服务
github.com/dominic-righthere安全038 周前更新

关于 envibe

envibe-mcp 是 MCP 服务,为 AI 编码助手提供受权限控制的环境变量访问。五种访问级别规定 AI 可查看或修改的内容;初始化时会生成清单和筛选后的 .env.ai 文件,并阻止直接访问 .env。

主要功能

  1. 01五种变量访问级别
  2. 02列出并读取获准变量
  3. 03仅 full 权限可设置变量
  4. 04查看变量格式和示例
  5. 05检查缺失的必需变量
  6. 06阻止直接访问 .env

适用场景

  1. 01限制助手查看机密信息
  2. 02允许编辑指定环境变量
  3. 03引导配置必需变量
  4. 04提供配置格式提示

MCP 相关

envibe-mcp 提供列出、读取、设置和描述环境变量,以及检查必需变量的工具。AI 客户端可通过 MCP 配置连接。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"dominic-righthere-envibe": {
"command": "npx",
"args": [
"-y",
"envibe-mcp"
]
}
}
}
启动命令npx -y envibe-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmenvibe-mcp0.2.7

工具

6

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

envibe-mcp

npm version License: MIT

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 会自动:

  1. 根据 .env.example 创建 .env.manifest.yaml
  2. 生成 .env.ai(供 AI 使用的筛选视图)
  3. 阻止直接访问 .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

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。