环境变量 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命令作为输入，从环境文件中加载环境变量，然后执行该命令。

有何作用？

将你的 MCP 服务器配置所需的秘密信息存储在 .env.mcp 文件中，并用这个代替...

{
  "my_database": {
    "command": "start-my-mcp-server",
    "args": [
      "我的秘密连接字符串",
    ]
  },
  "my_other_mcp_server": {
    "command": "start-my-other-mcp-server",
    "env": {
      "MY_API_KEY": "我的 API 密钥"
    }
  }
}

... 用这个：

{
  "my_database": {
    "command": "npx",
    "args": [
      "envmcp",
      "start-my-mcp-server",
      "$MY_DATABASE_CONNECTION_STRING",
    ]
  },
  "my_other_mcp_server": {
    "command": "npx",
    "args": [
      "envmcp",
      "start-my-other-mcp-server",
    ]
  }
}

安装

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=另一个测试值

贡献与开发

如果要为该项目做出贡献或进行开发，请参考项目仓库中的 CONTRIBUTING.md。

发布

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

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