env-mcp

An MCP (Model Context Protocol) server that exposes environment variables to MCP clients.

Overview

This MCP server provides a single tool, list_environment_variables, which returns all environment variables that are exposed to the server process, including their names and values.

Installation

npm install
npm run build

Usage

The server communicates over stdio (standard input/output) following the MCP protocol.

As a standalone server

node dist/index.js

In an MCP client configuration

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "env-mcp": {
      "command": "node",
      "args": ["/path/to/env-mcp/dist/index.js"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "env-mcp": {
      "command": "env-mcp"
    }
  }
}

Available Tools

list_environment_variables

Returns a list of all environment variables exposed to the MCP server.

Parameters: None

Returns: A JSON array of objects, each containing:

• name: The environment variable name
• value: The environment variable value

Example output:

[
  {
    "name": "PATH",
    "value": "/usr/local/bin:/usr/bin:/bin"
  },
  {
    "name": "HOME",
    "value": "/home/user"
  },
  ...
]

Development

Build

npm run build

Watch mode

npm run watch

Run in development mode

npm run dev

License

ISC