Auggie MCP

🚀 Auggie MCP 服務器

Auggie MCP 服務器是一個輕量級的 MCP 服務器，它將 Auggie CLI 作為問答和代碼實現的工具對外提供服務。

✨ 主要特性

• ask_question：通過 Auggie 的上下文引擎進行倉庫問答。
• implement：在倉庫中實現更改；默認以預運行模式執行。

📦 安裝指南

環境要求

• Node.js 18 及以上版本。
• 系統中需安裝 Python 3.10 及以上版本（內部使用，無需手動設置）。
• 已安裝 Auggie CLI（可通過運行 auggie --version 進行檢查） - 詳見 安裝指南。

🔐 身份驗證（AUGMENT_API_TOKEN）

可通過 Auggie CLI 獲取令牌：

# 確保 Auggie CLI 已安裝並在系統路徑中
auggie --version

# 登錄（會打開瀏覽器流程）
auggie login

# 打印令牌
auggie --print-augment-token

可以通過以下兩種方式提供令牌：

Cursor/Claude 配置（推薦）

在服務器的 env 下進行設置：

{
  "mcpServers": {
    "auggie-mcp": {
      "command": "npx",
      "args": ["-y", "auggie-mcp@latest"],
      "env": { "AUGMENT_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

shell 環境（macOS/Linux）

單次命令使用

AUGMENT_API_TOKEN=YOUR_TOKEN npx -y auggie-mcp --setup-only

持久化設置（zsh）

echo 'export AUGMENT_API_TOKEN=YOUR_TOKEN' >> ~/.zshrc
source ~/.zshrc

⚠️ 重要提示

切勿將令牌提交到版本控制系統。建議使用每臺機器的環境變量或客戶端的安全配置存儲。

🛠️ 配置客戶端

通過 npx 配置 Cursor

在 Cursor（全局或每個項目）中使用以下 MCP 配置：

{
  "mcpServers": {
    "auggie-mcp": {
      "command": "npx",
      "args": ["-y", "auggie-mcp@latest"],
      "env": { "AUGMENT_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

此配置將執行以下操作：

• 下載包裝器包。
• 在包內創建本地 Python 虛擬環境。
• 安裝 requirements.txt 中的依賴項。
• 以 stdio 模式啟動 Python 服務器。

通過 npx 進行快速測試（終端）

# 將依賴項安裝到包的本地虛擬環境中（不進行全局安裝）
npx -y auggie-mcp --setup-only

# 運行服務器（stdio 模式）。適用於快速冒煙測試。
npx -y auggie-mcp

# 可選：啟動 HTTP 模式以進行手動調試
npx -y auggie-mcp -- --http

Claude Desktop（macOS）

編輯 ~/Library/Application Support/Claude/claude_desktop_config.json 並添加以下內容：

{
  "mcpServers": {
    "auggie-mcp": {
      "command": "npx",
      "args": ["-y", "auggie-mcp@latest"],
      "env": { "AUGMENT_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

🔒 安全與權限

• 默認設置：implement 以預運行模式運行。不會寫入文件，也不會執行 shell 命令；您將獲得一個建議的差異。
• 啟用寫入：將 dry_run 設置為 false。
• 建議：使用功能分支，並在合併之前審查差異。