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。
• 建议：使用功能分支，并在合并之前审查差异。