Envmcp

🚀 環境変数 MCP ツールキット（envmcp）

Cursor MCP サーバーの定義で環境変数を使用できるようにします。

🚀 クイックスタート

stdio コマンドの接頭辞に npx envmcp を使用し、カーソル 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"
    ]
  }
}

✨ 主な機能

シェルコマンドを入力として受け取り、環境ファイルから環境変数を読み込み、そのコマンドを実行します。

機能の説明

MCP サーバーの設定に必要な機密情報を .env.mcp ファイルに保存し、これを代わりに使用します...

{
  "my_database": {
    "command": "start-my-mcp-server",
    "args": [
      "私の秘密の接続文字列"
    ]
  },
  "my_other_mcp_server": {
    "command": "start-my-other-mcp-server",
    "env": {
      "MY_API_KEY": "私の API キー"
    }
  }
}

... これで置き換えます。

{
  "my_database": {
    "command": "npx",
    "args": [
      "envmcp",
      "start-my-mcp-server",
      "$MY_DATABASE_CONNECTION_STRING"
    ]
  },
  "my_other_mcp_server": {
    "command": "npx",
    "args": [
      "envmcp",
      "start-my-other-mcp-server"
    ]
  }
}

📦 インストール

npm install -g envmcp

💻 使用例

基本的な使用法

envmcp [--env-file <パス>] <コマンド> [<引数>...]

このツールは以下の手順で動作します。

1. カレントディレクトリで .env.mcp ファイルを検索します。
2. 見つからない場合は、ユーザーのホームディレクトリで ~/.env.mcp ファイルを検索します。
3. 環境変数ファイルの内容を復号化し、プロセスの環境変数に読み込みます。

高度な使用法

# 環境変数ファイルのパスを指定する例
envmcp --env-file /path/to/my.env.file start-my-mcp-server

コマンドラインオプション

• -e, --env-file <パス>：使用する環境変数ファイルのパスを指定します。
• -h, --help：ヘルプ情報を表示します。
• --version：ツールのバージョンを表示します。

📚 ドキュメント

環境ファイルの形式

.env.mcp ファイルの各行は、等号で区切られたキーと値のペアである必要があります。例えば：

MY_ENV_VAR=私の環境変数の値
ANOTHER_VAR=別の値

例

echo "内容を.env.mcp ファイルに書き込む"
MY_ENV_VAR=テスト値
ANOTHER_ENV_VAR=別のテスト値

貢献と開発

このプロジェクトに貢献したり開発したりする場合は、プロジェクトリポジトリの CONTRIBUTING.md を参照してください。

リリース

新しいバージョンをリリースするには、以下の手順に従ってください。

1. package.json ファイルでパッケージのバージョン番号を更新します。
2. 変更をコミットし、リモートリポジトリにプッシュします。
3. npm run release スクリプトを実行して、新しいリリースを生成します。