Envmcp

🚀 环境变量 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 <路径>] <命令> [<参数>...]

该工具将按以下步骤操作：

1. 在当前目录中查找 .env.mcp 文件。
2. 如果找不到，则在用户主目录中查找 ~/.env.mcp 文件。
3. 解密并加载环境变量文件中的内容到进程的环境变量中。

高级用法

以下是命令行选项说明：

• -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。

📄 发布

若要发布新版本，请按照以下步骤操作：

1. 更新包的版本号在 package.json 文件中。
2. 提交更改并推送到远程仓库。
3. 运行 npm run release 脚本来生成新的发行版。