STARWARCLOUD STARWAR.AI
返回市场
奥吉上下文MCP服务器

奥吉上下文MCP服务器

作者：aj475 星标更新：2025-11-06
安装使用来源：spider==github.com

项目介绍

Auggie Context MCP Server

npm 版本 许可证: MIT

这是一个暴露 Auggie CLI 以检索代码库上下文的模型上下文协议 (MCP) 服务器。这允许像 Claude、Cursor 等 AI 代理使用 Augment 强大的上下文引擎查询代码库。

快速开始

此 MCP 服务器设计用于与 MCP 客户端如 Claude Desktop 或 Cursor 一起使用。它不能独立使用。

前提条件

  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. 重启 Claude Desktop
  2. 您现在应该可以在 Claude 中看到 query_codebase 工具

注意: 如果需要使用特定的令牌而不是您的 Auggie CLI 登录，可以添加一个带有 AUGMENT_SESSION_AUTH 的 env 部分。详情见 认证 部分。

使用 Cursor 设置

  1. 在项目或全局中创建或编辑 .cursor/mcp.json
  2. 添加上述相同的配置
  3. 重启 Cursor

详见 安装及使用 部分的详细说明。

功能

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

要求

  • Node.js 18+
  • 已安装并添加到 PATH 的 Auggie CLI
  • Augment 认证（见下方认证部分）

认证

服务器支持两种认证方法：

方法 1: Auggie CLI 登录（推荐）

只需使用 Auggie CLI 登录：

auggie login

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

方法 2: 环境变量 (AUGMENT_SESSION_AUTH)

或者，您可以通过 AUGMENT_SESSION_AUTH 环境变量提供明确的访问令牌。

获取您的令牌：

# 1. 确保已安装 Auggie CLI
auggie --version

# 2. 登录 Augment（打开浏览器）
auggie login

# 3. 打印您的访问令牌
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 环境中设置：

# 获取您的令牌
TOKEN=$(auggie token print | grep '^TOKEN=' | cut -d= -f2-)

# 当前会话一次性设置
export AUGMENT_SESSION_AUTH="$TOKEN"

# 或持久化到 ~/.zshrc 或 ~/.bashrc
echo "export AUGMENT_SESSION_AUTH='$TOKEN'" >> ~/.zshrc
source ~/.zshrc

我应该使用哪种方法？

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

⚠️ 安全: 切勿将令牌提交到源代码控制。使用环境变量或安全配置存储。

安装及使用

注意: 此服务器设计用于与 MCP 客户端（Claude Desktop, Cursor 等）一起使用。它通过 stdio 使用 MCP 协议，不能独立运行。

Cursor 配置

添加到您的 Cursor 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\"]}"
      }
    }
  }
}

Claude Desktop (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\"]}"
      }
    }
  }
}

Claude Desktop (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 中的示例用法:

这个代码库的架构是什么？

身份验证系统是如何工作的？

用户注册逻辑在哪里实现？

展示一下支付处理是如何处理的。

开发

设置

# 克隆仓库
git clone https://github.com/aj47/auggie-mcp.git
cd auggie-mcp

# 安装依赖
npm install

# 构建
npm run build

开发模式

# 监控模式（更改时自动重建）
npm run watch

# 开发模式运行
npm run dev

本地测试

# 构建项目
npm run build

# 确保您已登录 Auggie
auggie login

# 使用 MCP Inspector 测试（推荐）
npx @modelcontextprotocol/inspector node dist/index.js

# 或使用真实 MCP 客户端（Claude Desktop, Cursor）测试
# 将其指向您的本地构建而不是 npx

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

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

架构

┌─────────────────────┐
│   AI 代理          │
│ (Claude, Cursor)    │
└──────────┬──────────┘
           │ MCP 协议 (stdio)
           ▼
┌─────────────────────┐
│ auggie-context-mcp  │
│  (TypeScript/Node)  │
│                     │
│  工具:              │
│  - query_codebase   │
└──────────┬──────────┘
           │ 子进程
           ▼
┌─────────────────────┐
│   Auggie CLI        │
│  --print --quiet    │
│                     │
│  Augment 上下文    │
│  引擎             │
└─────────────────────┘

故障排除

服务器未出现在 Claude/Cursor 中

  1. 检查配置文件语法: 确保您的 JSON 是有效的（没有尾随逗号，正确的引号）
  2. 验证认证: 确保您已运行 auggie login 或在配置中设置了 AUGMENT_SESSION_AUTH
  3. 重启客户端: 完全退出并重新启动 Claude Desktop 或 Cursor
  4. 检查日志:
    • Claude Desktop (macOS): ~/Library/Logs/Claude/mcp*.log
    • Claude Desktop (Windows): %APPDATA%\Claude\logs\mcp*.log
    • Cursor: 在设置中检查 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. 将其添加到您的 MCP 配置中的 env 部分（参见上面的示例）

"查询超时"

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

工具未出现在 Claude/Cursor 中

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

安全

  • 只读: 此服务器仅查询代码库；无法修改文件
  • 令牌安全: 切勿将 AUGMENT_SESSION_AUTH 提交到版本控制
  • 工作区隔离: 查询范围限于指定的工作区

许可证

MIT

贡献

欢迎贡献！请随意提交拉取请求。

链接