mcpField
E
envmcp

envmcp

ローカル
github.com/griffithsbs開発ツール3271 週間前に更新
リポジトリ

envmcp について

envmcp は、Cursor の MCP サーバー定義で環境変数を使うための軽量なコマンドラインツールです。シークレットをクライアントの設定ファイルから切り離し、認証情報を管理する Cursor ユーザーに向いています。npm パッケージとして提供されています。

主な機能

  1. 01コマンド引数内の $VARIABLE 参照の置換
  2. 02カスタム環境ファイルパスの指定
  3. 03カレント、親、ホームディレクトリの .env.mcp の検索
  4. 04npx または npm によるグローバルインストール

活用シーン

  1. 01Cursor の MCP 設定にデータベース接続文字列を平文で残さないこと
  2. 02複数の MCP サーバー定義で API キーを共通管理すること

MCP 対応

本ツールは MCP サーバーの起動コマンドをラップし、置換済みの引数を渡す仕組みです。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 サーバーの定義で環境変数を使用できます。

💡 さらに多くの機能をお探しですか？ envmcp の機能に加えて、デバッグツールなどを備えた mcpipe（npm）をご検討ください。

クイックスタート

# 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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。