现在有一个官方的增强代码上下文引擎MCP：
https://docs.augmentcode.com/context-services/mcp/overview
______________________________________________________________________
Auggie上下文MCP服务器
一个模型上下文协议（MCP）服务器，它公开Auggie CLI用于代码库上下文检索。这允许像Claude、Cursor和其他AI代理使用Augment强大的上下文引擎查询代码库。
快速开始
此MCP服务器设计用于MCP客户端，如 克劳德桌面版 或 光标。它不能单独使用。
先决条件
- 安装Auggie CLI: https://docs.augmentcode.com/cli/overview
- 与Auggie进行身份验证:
auggie login这将打开一个浏览器进行身份验证。登录后，您就可以开始了！
使用Claude Desktop进行设置
- 编辑
~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或%APPDATA%\Claude\claude_desktop_config.json（Windows） - 添加此配置：
{
"mcpServers": {
"auggie-context": {
"command": "npx",
"args": ["-y", "auggie-context-mcp@latest"]
}
}
}- 重新启动克劳德桌面
- 现在你应该看到
query_codebaseClaude中提供的工具
备注：如果您需要使用特定令牌而不是Auggie CLI登录，您可以添加 env 部分与 AUGMENT_SESSION_AUTH。请参阅 认证 详情请参阅第节。
使用光标进行设置
- 创建或编辑
.cursor/mcp.json在您的项目或全球范围内 - 添加与上述相同的配置
- 重新启动游标
看 安装与使用 详细说明部分。
特性
- 🔍 代码库查询：使用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-20241022rules_path（可选）：附加规则文件的路径timeout_sec（可选）：查询超时（秒）。默认值：240output_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中
- 检查配置文件语法：确保JSON有效（没有尾随逗号，引号正确）
- 验证身份验证：确保你跑过了
auggie login或设置AUGMENT_SESSION_AUTH在配置中 - 重新启动客户端：完全退出并重新启动Claude Desktop或Cursor
- 检查日志:
- 克劳德桌面（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配置中设置显式令牌
- 跑
auggie token print获取您的代币 - 复制整个JSON值（之后的所有内容
TOKEN=) - 将其添加到
envMCP配置中的部分（见上面的示例）
“查询超时”
对于大型代码库，查询可能需要更长的时间。默认超时为240秒（4分钟）。如果需要更多时间，您目前无法在MCP客户端配置中配置它，但可以修改源代码并重新生成。
工具未出现在Claude/Cursor中
- 验证服务器是否在MCP配置中正确配置
- 检查配置文件是否在正确的位置
- 重新启动客户端应用程序
- 寻找
query_codebase可用工具列表中的工具
安全
- 只读：此服务器仅查询代码库；它无法修改文件
- 代币安全：从不承诺
AUGMENT_SESSION_AUTH到版本控制 - 工作空间隔离：查询的作用域为指定的工作区
许可证
麻省理工学院
贡献
欢迎投稿！请随时提交拉取请求。