mcpField
E
envmcp

envmcp

本地服务
github.com/griffithsbs开发工具3271 周前更新
代码仓库

关于 envmcp

envmcp 是一个轻量命令行工具，用于在 Cursor 的 MCP 服务定义中使用环境变量。它可以把密钥从客户端配置中移出，适合需要管理凭据的 Cursor 用户。

主要功能

  1. 01在命令参数中替换 $VARIABLE 形式的变量
  2. 02支持自定义 env 文件路径
  3. 03按当前目录、父目录与主目录顺序查找 .env.mcp
  4. 04通过 npx 或全局安装使用

适用场景

  1. 01避免在 Cursor 的 MCP 配置中明文保存数据库连接字符串
  2. 02为多个 MCP 服务统一管理 API Key

MCP 相关

该项目是包装 MCP 服务启动命令的工具，用于在 Cursor 中注入配置好的参数，本身不直接暴露 MCP 工具。

#config#credentials#mcp#configuration#secret-management#secrets#environment-variables#env#cursor#cursor-ide#cursor-ai#mcp-server

配置

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

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

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

安装包
npmenvmcp

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

envmcp

npm version total downloads

在 Cursor MCP 服务定义中使用环境变量。

💡 想要更多功能？ 不妨试试 mcpipe（npm），它不仅包含 envmcp 的功能，还提供调试工具和其他功能。

快速入门

# Use default ~/.env.mcp file
npx envmcp your-mcp-server $DATABASE_URL

# Specify custom env file
npx envmcp --env-file .env your-mcp-server $API_KEY $DATABASE_URL

# Short flag version
npx envmcp -e /path/to/secrets.env your-mcp-server $MY_SECRET

在 MCP 客户端中使用

在服务命令前加上 envmcp。

之前（密钥暴露在配置中）：

{
  "my_database": {
    "command": "my-mcp-server",
    "args": ["postgresql://user:password@hostname/db"]
  }
}

之后（密钥位于 ~/.env.mcp 中）：

{
  "my_database": {
    "command": "npx",
    "args": ["envmcp", "my-mcp-server", "$DATABASE_URL"]
  }
}

工作原理

  1. 先在当前目录中查找 .env.mcp，然后逐级查找父目录，最后查找 ~/.env.mcp
  2. 如果指定了 --env-file，则改用该文件
  3. 从文件中加载环境变量
  4. 替换命令参数中的 $VARIABLE_NAME 引用
  5. 使用替换后的值执行命令

安装

npm install -g envmcp

选项

  • --env-file <path>、-e <path>：指定自定义环境文件路径

环境文件格式

DATABASE_URL=postgresql://user:password@localhost/db
API_KEY=your-secret-api-key
# This is a comment
QUOTED_VALUE="value with spaces"

更多示例请参阅 sample.env.mcp。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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