Envmcp

🚀 環境變量 MCP 工具包（envmcp）

envmcp 工具包可讓你在 Cursor MCP 服務器定義中靈活使用環境變量，有效管理服務器配置所需的機密信息，提升配置的安全性和可維護性。

🚀 快速開始

在 stdio 命令前綴使用 npx envmcp，並在遊標 MCP 配置裡按名稱引用環境變量。你可通過傳遞環境文件路徑作為參數，或把機密信息存入用戶主目錄下名為 .env.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 命令作為輸入，從環境文件加載環境變量，再執行該命令。

📦 安裝指南

使用以下命令全局安裝 envmcp：

npm install -g envmcp

💻 使用示例

基礎用法

envmcp [--env-file <路徑>] <命令> [<參數>...]

該工具會按以下步驟處理環境變量文件：

1. 在當前目錄查找 .env.mcp 文件。
2. 若當前目錄未找到，在用戶主目錄查找 ~/.env.mcp 文件。
3. 解密並加載環境變量文件內容到進程的環境變量中。

高級用法

# 指定環境變量文件路徑
envmcp --env-file /path/to/custom.env start-my-server

📚 詳細文檔

命令行選項

環境文件格式

.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 腳本來生成新的發行版。