Secret MCP

🚀 Secret MCP

Secret MCP是一款桌面應用程序，用於與MCP服務器協同管理機密信息。它能讓AI編碼助手編寫 .env 文件，同時確保機密值不被洩露。

🚀 快速開始

Secret MCP為開發者提供了一種安全且便捷的方式來管理和使用機密信息。通過與MCP服務器集成，AI編碼助手可以在不接觸機密值的情況下編寫 .env 文件，有效避免了機密信息的洩露風險。

✨ 主要特性

• 桌面應用：提供一個簡潔的窗口，用於管理機密信息（包括名稱、描述和值）。
• MCP服務器：為AI助手提供兩個工具：
  • 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返回機密信息的名稱和描述。
• 使用 600 權限寫入 .env 文件（僅所有者可讀寫）。

技術棧

• 桌面端：Tauri 2.0 + Svelte 5 + TypeScript
• MCP服務器：Node.js + @modelcontextprotocol/sdk + better-sqlite3

📄 許可證

本項目採用MIT許可證。