Skip to main content
Glama
Windyhhh

Augment-MCP-Proxy

by Windyhhh

🔌 Augment MCP 프록시 서버 | Augment MCP Proxy

Augment에서 제3자 Anthropic API 사용 — 크레딧 절약

Augment(Anthropic 공식 VS Code 플러그인)를 제3자 Anthropic API에 연결하는 경량 MCP 프록시 서버로, Augment 크레딧을 소모하지 않고 제3자 API 할당량만 사용합니다. 완전히 로컬에서 실행되며 코드 분석이 로컬에서 완료되므로 개인정보가 안전합니다.

Augment(Anthropic의 공식 VS Code 확장 프로그램)를 제3자 Anthropic API에 연결하는 경량 MCP 프록시 서버로, Augment 크레딧을 절약합니다. 코드 분석이 사용자 기기에서 이루어지므로 완전히 로컬로 실행되어 개인정보가 보호됩니다.


✨ 핵심 기능

기능

설명

💰 비용 절약

Augment 크레딧을 사용하지 않고 제3자 API 할당량만 사용

🔄 완벽한 통합

Augment 사용 경험이 완전히 동일하며 모든 기능 지원

🔒 로컬 실행

코드 분석이 로컬에서 완료되고 소스 코드가 업로드되지 않아 개인정보 안전

🤖 다중 모델 지원

Haiku / Sonnet / Opus 세 가지 모델을 자유롭게 전환

경량

의존성이 단 2개(axios + dotenv), 시작이 몇 초면 충분

🪟 크로스 플랫폼

Windows / macOS / Linux 모두 지원


Related MCP server: LiteLLM MCP Server Bridge

🏗️ 작동 원리

┌──────────────┐     HTTP      ┌──────────────────┐     HTTPS      ┌──────────────────┐
│   Augment    │ ────────────→ │  MCP Proxy       │ ─────────────→ │  Third-Party     │
│   (VS Code)  │ ←──────────── │  (localhost:3000)│ ←───────────── │  Anthropic API   │
└──────────────┘    响应       └──────────────────┘    响应         └──────────────────┘
                                    │
                                    ├─ /v1/models    → 模型列表
                                    ├─ /v1/messages  → 消息转发
                                    └─ /health        → 健康检查

Augment 플러그인은 MCP 프로토콜을 통해 로컬 프록시 서버에 연결되고, 프록시는 요청을 제3자 Anthropic API로 전달한 후 응답을 다시 Augment에 반환합니다. 전체 과정은 Augment 입장에서 완전히 투명하게 동작합니다.


🚀 빠른 시작

환경 요구 사항

Node.js >= 14.0
npm >= 6.0

설치 단계

# 1. 克隆项目
git clone https://github.com/Windyhhh/Augment-MCP-Proxy.git
cd Augment-MCP-Proxy

# 2. 安装依赖
npm install

# 3. 配置环境变量
cp .env.example .env
# 编辑 .env,填入你的第三方 API Key

.env 설정

# 第三方 API 地址(兼容 Anthropic 格式的 API)
THIRD_PARTY_API=https://your-api-endpoint.com/anthropic

# 你的 API Key
API_KEY=sk-your-api-key-here

# MCP 服务器端口(默认 3000)
MCP_PORT=3000

서버 시작

# 方式一:npm
npm start

# 方式二:直接运行
node index.js

# 方式三(Windows):PowerShell 脚本
.\start-server.ps1 start

시작에 성공하면 다음과 같은 출력이 표시됩니다:

========================================
MCP 代理服务器启动成功!
========================================
服务器地址:http://localhost:3000
第三方 API:https://your-api-endpoint.com/anthropic
支持的模型:
  - claude-3-haiku-20240229 (Claude 3 Haiku)
  - claude-3-sonnet-20240229 (Claude 3 Sonnet)
  - claude-3-opus-20240229 (Claude 3 Opus)
========================================

⚙️ Augment 구성

1. MCP 구성 파일 찾기

Windows:

%APPDATA%\Code\User\globalStorage\anthropic.augment\mcp-servers.json

macOS:

~/Library/Application Support/Code/User/globalStorage/anthropic.augment/mcp-servers.json

Linux:

~/.config/Code/User/globalStorage/anthropic.augment/mcp-servers.json

2. 설정 작성

위 파일에 mcp-servers.json의 내용을 복사합니다:

{
  "mcpServers": {
    "augment-proxy": {
      "command": "node",
      "args": ["path/to/index.js"],
      "env": {
        "MCP_PORT": "3000"
      }
    }
  }
}

3. VS Code 재시작

VS Code를 완전히 종료한 후 다시 열고, 5~10초 정도 기다려 MCP 서버가 로드되게 합니다.

4. 사용 시작

Augment 채팅에 다음을 입력합니다:

use claude-3-haiku-20240229, 你好!请给我一个 Python Hello World 示例

🧪 테스트 확인

헬스 체크

curl http://localhost:3000/health

예상 출력:

{"status":"ok","timestamp":"2025-01-01T00:00:00.000Z"}

모델 목록 가져오기

curl http://localhost:3000/v1/models

테스트 스크립트 실행(Windows)

.\test-api.ps1

비용 절약 확인

MCP 프록시 사용 전후의 Augment 크레딧 잔액을 비교해 보면 줄어들지 않아야 합니다.


📁 프로젝트 구조

Augment-MCP-Proxy/
├── README.md                  # 本文件
├── package.json               # 项目配置
├── package-lock.json          # 依赖锁定
├── .env.example               # 环境变量模板
├── .gitignore                 # Git 忽略规则
├── index.js                   # MCP 代理服务器主文件
├── start-server.ps1           # Windows 启动/停止/重启脚本
├── test-api.ps1               # API 测试脚本
├── mcp-servers.json           # Augment MCP 配置示例
└── AUGMENT_CONFIG_GUIDE.md    # Augment 详细配置指南

🔧 API 인터페이스

GET /health

헬스 체크 엔드포인트입니다.

응답:

{
  "status": "ok",
  "timestamp": "2025-01-01T00:00:00.000Z"
}

GET /v1/models

지원되는 모델 목록을 가져옵니다.

응답:

{
  "object": "list",
  "data": [
    {
      "id": "claude-3-haiku-20240229",
      "object": "model",
      "created": 1735689600,
      "owned_by": "anthropic"
    }
  ]
}

POST /v1/messages

메시지 요청을 제3자 API에 전달합니다.

요청 본문:

{
  "model": "claude-3-sonnet-20240229",
  "max_tokens": 4096,
  "messages": [
    {"role": "user", "content": "Hello!"}
  ],
  "temperature": 0.7
}

🎯 지원 모델

모델

속도

품질

비용

최적 용도

Haiku

⚡⚡⚡

⭐⭐

가장 낮음

간단한 질문, 코드 완성, 일상 대화

Sonnet

⚡⚡

⭐⭐⭐⭐

중간

일반 작업, 코드 리뷰, 기본 권장

Opus

⭐⭐⭐⭐⭐

높은 편

복잡한 문제, 아키텍처 설계, 심층 분석

Augment에서 모델을 전환하려면:

use claude-3-haiku-20240229, ...
use claude-3-sonnet-20240229, ...
use claude-3-opus-20240229, ...

🛠️ PowerShell 스크립트 사용법

# 启动服务器
.\start-server.ps1 start

# 停止服务器
.\start-server.ps1 stop

# 重启服务器
.\start-server.ps1 restart

# 测试连接
.\start-server.ps1 test

❓ 자주 묻는 질문

Q: 서버가 시작되지 않나요?

A: .env 파일의 API_KEY가 올바르게 설정되어 있는지 확인하고, 불필요한 공백이나 따옴표가 없도록 확인하세요.

Q: 포트 3000이 이미 사용 중입니다?

A: .envMCP_PORT를 다른 포트(예: 3001)로 변경한 다음, Augment의 MCP 구성을 업데이트하세요.

Q: Augment에 새 모델이 표시되지 않나요?

A: VS Code를 완전히 종료(창만 닫는 것 아님)한 후 다시 열고, 5~10초 정도 기다려 MCP 서버가 로드되게 하세요.

Q: 실제로 비용이 절약되는지 어떻게 확인하나요?

A: MCP 프록시 사용 전후의 Augment 크레딧 잔액을 비교해 보세요. 잔액이 줄어들지 않아야 합니다. 모든 요청은 제3자 API로 전달됩니다.

Q: 스트리밍 출력을 지원하나요?

A: 현재 버전은 표준 비스트리밍 응답을 지원합니다. 스트리밍(SSE) 지원은 개발 중입니다.

Q: 여러 API를 동시에 연결할 수 있나요?

A: 현재 버전은 단일 인스턴스에서 단일 API를 지원합니다. 여러 인스턴스를 서로 다른 포트로 실행하면 각각 다른 API를 구성할 수 있습니다.


⚠️ 주의사항

  1. API 키 보안: .env 파일에는 민감한 정보가 포함되어 있으며, .gitignore에 포함되어 있으므로 공개 저장소에 커밋하지 마세요.

  2. 네트워크 요구 사항: 제3자 API 주소에 접근할 수 있는지 확인하세요.

  3. API 호환성: 제3자 API는 Anthropic Messages API 형식과 호환되어야 합니다.

  4. 속도 제한: 제3자 API의 속도 제한이 적용됩니다.

  5. Augment 버전: 최신 버전의 Augment 플러그인을 사용하는 것을 권장합니다.


📄 라이선스

MIT License — 자유롭게 사용, 수정, 배포할 수 있습니다.


🤝 기여

Issue와 Pull Request를 환영합니다!


📌 관련 링크


🔌 모든 코드를 더 저렴하게 🔌

문제 보고 · 제안하기

F
license - not found
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Connect AI agents to Replynodes over the Model Context Protocol.

  • Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Windyhhh/Augment-MCP-Proxy'

If you have feedback or need assistance with the MCP directory API, please join our Discord server