🚀 环境变量 MCP 工具包（envmcp）
环境变量 MCP 工具包（envmcp）允许你在 Cursor MCP 服务器定义中使用环境变量，有效管理服务器配置所需的秘密信息，提升安全性和可维护性。
🚀 快速开始
在你的 stdio 命令前缀中使用 npx envmcp，并在你的游标 MCP 配置中按名称引用环境变量。
基础用法
{
"my_mcp_server": {
"command": "npx",
"args": [
"envmcp",
"--env-file",
"/path/to/my.env.file",
"start-my-mcp-server",
"$MY_NAMED_ENVIRONMENT_VARIABLE"
]
},
"example_with_shorthand_flag_name": {
"command": "npx",
"args": [
"envmcp",
"-e",
"/path/to/my.env.file",
"npx",
"pull-something-else-with-npx",
"$MY_DATABASE_CONNECTION_STRING"
]
}
}
高级用法
将你的机密信息放入用户主目录中的一个名为 .env.mcp 的文件中，该文件将被默认查找：
{
"my_mcp_server": {
"command": "npx",
"args": [
"envmcp",
"start-my-mcp-server",
"$MY_NAMED_ENVIRONMENT_VARIABLE"
]
}
}
✨ 主要特性
接收一个 shell 命令作为输入，从环境文件中加载环境变量，然后执行该命令。
📦 安装指南
npm install -g envmcp
💻 使用示例
基础用法
envmcp [--env-file <路径>] <命令> [<参数>...]
该工具将按以下步骤操作：
- 在当前目录中查找
.env.mcp文件。 - 如果找不到，则在用户主目录中查找
~/.env.mcp文件。 - 解密并加载环境变量文件中的内容到进程的环境变量中。
高级用法
以下是命令行选项说明：
-e, --env-file <路径>：指定要使用的环境变量文件的路径。-h, --help：显示帮助信息。--version：显示工具版本。
📚 详细文档
环境文件格式
.env.mcp 文件中的每一行都应该是一个以等号分隔的键值对，例如：
MY_ENV_VAR=我的环境变量值
ANOTHER_VAR=另一个值
示例
echo "内容写入.env.mcp 文件"
MY_ENV_VAR=测试值
ANOTHER_ENV_VAR=另一个测试值
🔧 技术细节
该工具的核心逻辑是接收 shell 命令，从指定或默认的环境文件中加载环境变量，然后执行该命令。通过将秘密信息存储在环境文件中，避免在配置文件中硬编码敏感信息，提高了安全性和可维护性。
📄 贡献与开发
如果要为该项目做出贡献或进行开发，请参考项目仓库中的 CONTRIBUTING.md。
📄 发布
若要发布新版本，请按照以下步骤操作：
- 更新包的版本号在
package.json文件中。 - 提交更改并推送到远程仓库。
- 运行
npm run release脚本来生成新的发行版。