Envmcp
What is Envmcp
envmcp is a lightweight tool designed to facilitate the use of environment variables in Cursor MCP server definitions, allowing for secure management of sensitive information.
Use cases
Use cases for envmcp include managing database connection strings, API keys, and other secrets in a secure manner, enabling developers to easily configure their MCP servers without hardcoding sensitive information.
How to use
To use envmcp, store your required secrets in a file named ‘.env.mcp’ in your home directory. Then, prefix your stdio command with ‘npx envmcp’ and reference the environment variables by name in your MCP configuration.
Key features
Key features of envmcp include the ability to load environment variables from a specified file, execute shell commands with those variables, and simplify the management of sensitive data in MCP server configurations.
Where to use
envmcp can be used in any environment where Cursor MCP servers are deployed, particularly in development and production settings that require secure handling of sensitive information.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Envmcp
envmcp is a lightweight tool designed to facilitate the use of environment variables in Cursor MCP server definitions, allowing for secure management of sensitive information.
Use cases
Use cases for envmcp include managing database connection strings, API keys, and other secrets in a secure manner, enabling developers to easily configure their MCP servers without hardcoding sensitive information.
How to use
To use envmcp, store your required secrets in a file named ‘.env.mcp’ in your home directory. Then, prefix your stdio command with ‘npx envmcp’ and reference the environment variables by name in your MCP configuration.
Key features
Key features of envmcp include the ability to load environment variables from a specified file, execute shell commands with those variables, and simplify the management of sensitive data in MCP server configurations.
Where to use
envmcp can be used in any environment where Cursor MCP servers are deployed, particularly in development and production settings that require secure handling of sensitive information.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
envmcp
Use environment variables in your Cursor MCP server definitions.
💡 Looking for more features? Consider mcpipe (npm) which includes envmcp’s functionality as well as debugging tools and other capabilities.
Quick Start
# 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
Usage in MCP Clients
Prefix your server command with envmcp.
Before (secrets exposed in config):
{
"my_database": {
"command": "my-mcp-server",
"args": [
"postgresql://user:password@hostname/db"
]
}
}After (secrets in ~/.env.mcp):
{
"my_database": {
"command": "npx",
"args": [
"envmcp",
"my-mcp-server",
"$DATABASE_URL"
]
}
}How It Works
- Looks for
.env.mcpin current directory, then parent directories, finally~/.env.mcp - If
--env-fileis specified, uses that file instead - Loads environment variables from the file
- Replaces
$VARIABLE_NAMEreferences in your command arguments - Executes the command with substituted values
Installation
npm install -g envmcp
Options
--env-file <path>,-e <path>: Specify custom environment file path
Environment File Format
DATABASE_URL=postgresql://user:password@localhost/db API_KEY=your-secret-api-key # This is a comment QUOTED_VALUE="value with spaces"
See sample.env.mcp for more examples.
License
MIT
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
