Vault MCP

🚀 HashiCorp Vault MCP 服務端

這是一個實現模型上下文協議（MCP）的服務端，它提供了與 HashiCorp Vault 的安全接口，能讓大型語言模型（LLM）和其他 MCP 客戶端與 Vault 的秘密和策略管理功能進行交互。

🚀 快速開始

通過此實現，LLM 可以執行以下操作：

• 通過結構化的 API 進行秘密的安全管理。
• 策略的創建和管理。
• 資源的發現和列表。
• 自動化策略生成。

✨ 主要特性

工具函數

秘密操作

• secret_create：創建秘密。
• secret_read：讀取秘密內容。
• secret_delete：刪除指定的秘密。

策略管理

• policy_create：創建新的 Vault 策略，指定允許訪問的路徑。

資源類型

秘密資源

• vault://secrets：列出所有可用的秘密路徑。

策略資源

• vault://policies：列出所有已定義的 Vault 策略。

自動生成策略

通過指定路徑和權限，生成相應的策略內容。例如：

{
  "policy_name": "app_read_only",
  "rules": {
    "path": "/secret/app/*",
    "capabilities": ["read"]
  }
}

📦 安裝指南

根據您的設置有不同的使用方式。

使用 Cursor（推薦）

在 Cursor MCP 配置中添加如下內容：

{
  "mcpServers": {
    "Vault MCP": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VAULT_ADDR=https://your-vault-server:8200",
        "-e",
        "VAULT_TOKEN=hvs.your-vault-token",
        "ashgw/vault-mcp:latest"
      ]
    }
  }
}

⚠️ 重要提示

如果您希望指定特定的 Docker 鏡像版本（例如，20250413-165732），請使用該標籤而不是 latest。可以在 Docker Hub 瀏覽可用版本。

添加後，可以使用如下提示：

"讀取路徑 apps/myapp/config 的 Vault 秘密"

Cursor 會自動將請求路由到 MCP 服務器。 檢查是否正常工作，界面應顯示綠色狀態

手動運行 Docker

設置環境變量 VAULT_ADDR 和 VAULT_TOKEN，並映射端口 3000：

docker run -it --rm -e "VAULT_ADDR=https://your-vault-server:8200" -e "VAULT_TOKEN=your-vault-token" -p 3000:3000 ashgw/vault-mcp:latest

從源代碼構建

克隆倉庫並運行：

git clone git@github.com:ashgw/vault-mcp.git
cd vault-mcp
go run main.go

💻 使用示例

基礎用法

添加 Vault MCP 服務器到 Cursor 配置，設置環境變量，並啟動服務：

VAULT_ADDR=https://vault.example.com:8200 VAULT_TOKEN=your_token docker run -p 3000:3000 ashgw/vault-mcp:latest

高級用法

測試功能

1. 創建策略：

   policy_create --name app_read_only --rules '{"path": "/secret/app/*", "capabilities": ["read"]}'
   

2. 列出所有秘密路徑：

   ls vault://secrets
   

3. 讀取特定秘密：

   cat vault://secrets/myapp/config
   

📚 詳細文檔

注意事項

⚠️ 重要提示

• 確保 Vault 服務器地址和令牌的正確性。
• 安全管理令牌，防止洩露。
• 在生產環境中建議使用受信任的網絡。

社區與支持

如需幫助或反饋，請訪問 HashiCorp 論壇 或聯繫官方支持。