Secret MCP

🚀 Secret MCP

AIコーディングアシスタントがシークレット値を見ることなく.envファイルを作成できるように、MCPサーバーを備えたシークレット管理用デスクトップアプリです。

🚀 クイックスタート

Secret MCPは、AIコーディングアシスタントがシークレット値を見ることなく.envファイルを作成できるようにするデスクトップアプリです。これにより、シークレット情報を安全に管理しながら、コーディング作業を効率化することができます。

✨ 主な機能

• デスクトップアプリ：シークレット（名前、説明、値）を管理するためのシンプルなウィンドウ。
• MCPサーバー：AIアシスタント用の2つのツール。
  • search_secrets：名前または説明でシークレットを検索（値は決して公開されません）。
  • write_env：シークレットを.envファイルに書き込む（値は直接ファイルに書き込まれ、AIには渡されません）。
• ローカルストレージ：すべてのシークレットがSQLiteにローカルに保存されます。
• npmパッケージ：npx secret-mcp ですぐに使用可能 - ビルド不要。

📦 インストール

デスクトップアプリ

リリースからダウンロードするか、ソースからビルドします。

npm install
npm run tauri build

MCPサーバーのセットアップ

MCPクライアントの設定に追加します。

"secret-mcp": {
  "command": "npx",
  "args": ["secret-mcp"]
}

💻 使用例

基本的な使用法

1. Secret MCPアプリを開きます。
2. シークレット（APIキー、トークンなど）を追加します。
3. AIでコーディングする際、自動的に search_secrets と write_env を使用して.envファイルを設定します。 （注：シークレットの名前は.envファイルの変数名になります）

高度な使用法

search_secrets

名前または説明でシークレットを検索します。返されるのは名前と説明のみで、値は決して公開されません。

// 入力
{ query: "openai" }

// 出力
[
  { name: "OPENAI_API_KEY", description: "OpenAI API key" }
]

write_env

シークレットを.envファイルに書き込みます。値はローカルデータベースから直接ファイルに書き込まれ、AIを介さずに渡されません。

// 入力
{
  keys: ["OPENAI_API_KEY", "DATABASE_URL"],
  path: "/Users/you/project/.env"
}

// 出力
"Successfully wrote 2 secret(s) to /Users/you/project/.env"

🔧 技術詳細

データストレージ

シークレットはローカルに保存されます。

• macOS：~/Library/Application Support/secret-mcp/secrets.db
• Linux：~/.local/share/secret-mcp/secrets.db
• Windows：%APPDATA%/secret-mcp/secrets.db

セキュリティ

• シークレット値は指定した.envファイル以外ではマシンを離れません。
• MCPサーバーはAIにシークレットの名前と説明のみを返します。
• .envファイルは600のパーミッションで書き込まれます（所有者の読み書きのみ許可）。

技術スタック

• デスクトップ：Tauri 2.0 + Svelte 5 + TypeScript
• MCPサーバー：Node.js + @modelcontextprotocol/sdk + better-sqlite3

📄 ライセンス

MIT