Auggie Context MCP

现在有一个官方的增强代码上下文引擎MCP：

https://docs.augmentcode.com/context-services/mcp/overview

______________________________________________________________________

Auggie上下文MCP服务器

](https://www.npmjs.com/package/auggie-context-mcp) 

一个模型上下文协议（MCP）服务器，它公开Auggie CLI用于代码库上下文检索。这允许像Claude、Cursor和其他AI代理使用Augment强大的上下文引擎查询代码库。

快速开始

此MCP服务器设计用于MCP客户端，如 克劳德桌面版 或 光标。它不能单独使用。

先决条件

1. 安装Auggie CLI: https://docs.augmentcode.com/cli/overview
2. 与Auggie进行身份验证:

   auggie login

这将打开一个浏览器进行身份验证。登录后，您就可以开始了！

使用Claude Desktop进行设置

1. 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）
2. 添加此配置：

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

1. 重新启动克劳德桌面
2. 现在你应该看到 query_codebase Claude中提供的工具

备注：如果您需要使用特定令牌而不是Auggie CLI登录，您可以添加 env 部分与 AUGMENT_SESSION_AUTH。请参阅 认证 详情请参阅第节。

使用光标进行设置

1. 创建或编辑 .cursor/mcp.json 在您的项目或全球范围内
2. 添加与上述相同的配置
3. 重新启动游标

看 安装与使用 详细说明部分。

特性

• 🔍 代码库查询：使用Augment的上下文引擎对存储库进行智能问答
• 🚀 简单设置：纯TypeScript/Node.js实现（不需要Python）
• 🔒 只读：无文件修改功能的安全上下文检索
• ⚡ 快速：与Auggie CLI直接集成
• 📦 易于分发：单个npm包，与 npx

需求

• Node.js 18+
• Auggie命令行界面 已安装并可在PATH上使用

- 安装：请参阅 Auggie CLI安装指南 - 验证： auggie --version

• 增强身份验证 （请参阅下面的身份验证部分）

认证

服务器支持两种身份验证方法：

选项1:Auggie CLI登录（推荐）

只需使用Auggie CLI登录：

auggie login

这将打开一个浏览器进行身份验证。登录后，MCP服务器将自动使用您的Auggie CLI会话。无需额外配置！

选项2：环境变量（AUGMENT_SESSION_AUTH）

或者，您可以通过以下方式提供显式访问令牌 AUGMENT_SESSION_AUTH 环境变量。

获取您的令牌：

# 1. Ensure Auggie CLI is installed
auggie --version

# 2. Sign in to Augment (opens browser)
auggie login

# 3. Print your access token
auggie token print

这将输出类似以下内容：

TOKEN={"accessToken":"your-token-here","tenantURL":"https://...","scopes":["read","write"]}

在MCP客户端配置中设置令牌：

将令牌添加到MCP客户端配置中：

{
  "mcpServers": {
    "auggie-context": {
      "command": "npx",
      "args": ["-y", "auggie-context-mcp@latest"],
      "env": {
        "AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token-here\",\"tenantURL\":\"https://...\",\"scopes\":[\"read\",\"write\"]}"
      }
    }
  }
}

或者在shell环境中设置：

# Get your token
TOKEN=$(auggie token print | grep '^TOKEN=' | cut -d= -f2-)

# One-time for current session
export AUGMENT_SESSION_AUTH="$TOKEN"

# Or persist in ~/.zshrc or ~/.bashrc
echo "export AUGMENT_SESSION_AUTH='$TOKEN'" >> ~/.zshrc
source ~/.zshrc

我应该使用哪种方法？

• 使用Auggie CLI登录 如果您是计算机上的唯一用户，并且希望进行最简单的设置
• 使用AUGMENT_SESSION_AUTH 如果需要使用特定令牌或处于共享/CI环境中

⚠️ 安全：永远不要将令牌提交到源代码管理。使用环境变量或安全配置存储。

安装与使用

备注：此服务器设计用于MCP客户端（Claude Desktop、Cursor等）。它在stdio上使用MCP协议，不能独立运行。

光标配置

添加到光标MCP配置(.cursor/mcp.json -全球或每个项目）：

简单的设置（使用您的Auggie CLI登录）：

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

使用显式令牌（可选）：

{
  "mcpServers": {
    "auggie-context": {
      "command": "npx",
      "args": ["-y", "auggie-context-mcp@latest"],
      "env": {
        "AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token-here\",\"tenantURL\":\"https://...\",\"scopes\":[\"read\",\"write\"]}"
      }
    }
  }
}

克劳德桌面（macOS）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

简单的设置（使用您的Auggie CLI登录）：

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

使用显式令牌（可选）：

{
  "mcpServers": {
    "auggie-context": {
      "command": "npx",
      "args": ["-y", "auggie-context-mcp@latest"],
      "env": {
        "AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token-here\",\"tenantURL\":\"https://...\",\"scopes\":[\"read\",\"write\"]}"
      }
    }
  }
}

克劳德桌面（Windows）

编辑 %APPDATA%\Claude\claude_desktop_config.json:

简单的设置（使用您的Auggie CLI登录）：

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

使用显式令牌（可选）：

{
  "mcpServers": {
    "auggie-context": {
      "command": "npx",
      "args": ["-y", "auggie-context-mcp@latest"],
      "env": {
        "AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token-here\",\"tenantURL\":\"https://...\",\"scopes\":[\"read\",\"write\"]}"
      }
    }
  }
}

可用工具

query_codebase

使用Augment的上下文引擎查询代码库。

参数：

• query （必填）：关于代码库的问题或疑问
• workspace_root （可选）：工作区/存储库根的绝对路径。默认为当前目录。
• model （可选）：要使用的型号ID。例子： claude-3-5-sonnet-20241022
• rules_path （可选）：附加规则文件的路径
• timeout_sec （可选）：查询超时（秒）。默认值：240
• output_format （可选）：输出格式(text 或 json).违约： text

Claude/Cursor中的用法示例：

What is the architecture of this codebase?

How does the authentication system work?

Where is the user registration logic implemented?

Show me how the payment processing is handled.

发展

设置

# Clone the repository
git clone https://github.com/aj47/auggie-mcp.git
cd auggie-mcp

# Install dependencies
npm install

# Build
npm run build

开发模式

# Watch mode (auto-rebuild on changes)
npm run watch

# Run in development
npm run dev

本地测试

# Build the project
npm run build

# Make sure you're logged in to Auggie
auggie login

# Test with MCP Inspector (recommended)
npx @modelcontextprotocol/inspector node dist/index.js

# Or test with a real MCP client (Claude Desktop, Cursor)
# by pointing it to your local build instead of npx

可选的：如果您想使用显式令牌而不是Auggie CLI登录进行测试：

export AUGMENT_SESSION_AUTH=$(auggie token print | grep '^TOKEN=' | cut -d= -f2-)
npx @modelcontextprotocol/inspector node dist/index.js

建筑

┌─────────────────────┐
│   AI Agent          │
│ (Claude, Cursor)    │
└──────────┬──────────┘
           │ MCP Protocol (stdio)
           ▼
┌─────────────────────┐
│ auggie-context-mcp  │
│  (TypeScript/Node)  │
│                     │
│  Tool:              │
│  - query_codebase   │
└──────────┬──────────┘
           │ subprocess
           ▼
┌─────────────────────┐
│   Auggie CLI        │
│  --print --quiet    │
│                     │
│  Augment Context    │
│  Engine             │
└─────────────────────┘

故障排除

服务器未显示在Claude/Cursor中

1. 检查配置文件语法：确保JSON有效（没有尾随逗号，引号正确）
2. 验证身份验证：确保你跑过了 auggie login 或设置 AUGMENT_SESSION_AUTH 在配置中
3. 重新启动客户端：完全退出并重新启动Claude Desktop或Cursor
4. 检查日志:

- 克劳德桌面（macOS）: ~/Library/Logs/Claude/mcp*.log - 克劳德桌面（Windows）: %APPDATA%\Claude\logs\mcp*.log - 光标：检查MCP登录设置

“找不到Auggie CLI”

服务器找不到Auggie CLI。确保它已安装并位于您的PATH中：

auggie --version

如果未找到，请从以下位置安装：https://docs.augmentcode.com/cli/overview

“需要身份验证”或“未登录”

Auggie CLI需要身份验证。您有两个选择：

选项1：使用Auggie CLI登录（推荐）

auggie login

选项2：在MCP配置中设置显式令牌

1. 跑 auggie token print 获取您的代币
2. 复制整个JSON值（之后的所有内容 TOKEN=)
3. 将其添加到 env MCP配置中的部分（见上面的示例）

“查询超时”

对于大型代码库，查询可能需要更长的时间。默认超时为240秒（4分钟）。如果需要更多时间，您目前无法在MCP客户端配置中配置它，但可以修改源代码并重新生成。

工具未出现在Claude/Cursor中

1. 验证服务器是否在MCP配置中正确配置
2. 检查配置文件是否在正确的位置
3. 重新启动客户端应用程序
4. 寻找 query_codebase 可用工具列表中的工具

安全

• 只读：此服务器仅查询代码库；它无法修改文件
• 代币安全：从不承诺 AUGMENT_SESSION_AUTH 到版本控制
• 工作空间隔离：查询的作用域为指定的工作区

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。

链接

• 增强代码
• Auggie CLI文档
• 模型上下文协议
• MCP规范