🔌 Servidor proxy MCP de Augment | Augment MCP Proxy

Usa una API de terceros con Anthropic en Augment: ahorra tus créditos

Un servidor proxy MCP ligero que conecta Augment (la extensión oficial de Anthropic para VS Code) con las API de terceros de Anthropic, de modo que no consumes créditos de Augment; solo usas tu cuota de API de terceros. Se ejecuta completamente en local, y el análisis del código se realiza en tu propio equipo para garantizar la privacidad.

Un servidor proxy MCP ligero que conecta Augment (la extensión oficial de Anthropic para VS Code) con API de terceros de Anthropic, ahorrarte créditos de Augment. Corre íntegramente en local y con el análisis del código en tu máquina para mantener la privacidad.

✨ Características principales

Related MCP server: LiteLLM MCP Server Bridge

🏗️ Cómo funciona

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

El plugin de Augment se conecta al servidor proxy local a través del protocolo MCP; el proxy reenvía la solicitud a la API de terceros de Anthropic y devuelve la respuesta a Augment. Todo el proceso es totalmente transparente para Augment.

🚀 Inicio rápido

Requisitos del sistema

Node.js >= 14.0
npm >= 6.0

Los pasos de instalación

# 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

Configurando .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

Usa el servidor

# 方式一：npm
npm start

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

# 方式三（Windows）：PowerShell 脚本
.\start-server.ps1 start

Cuando se inicia correctamente verás:

========================================
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)
========================================

⚙️ Configuración de Augment

1. Encuentra el archivo de configuración 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. Escribe la configuración

Copia el contenido de mcp-servers.json en el archivo anterior:

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

5. Recarga VS Code

Cierra VS Code totalmente y vuelve a abrirlo, esperde 5 a 10 segundos para que el servidor MCP se cargue.

4. Deja usarlo

En la charla de Augment escribe:

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

🧪 Prueba y verificación

Comprobación de estado de salud

curl http://localhost:3000/health

Salida esperada:

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

Consulta lista de modelos

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

Ejecutar script de prueba (Windows)

.\test-api.ps1

Confirmación del ahorro

Si comparas el saldo de créditos de Augment antes y después del proxy MCP, no debería consumirse ningún crédito.

📁 Estructura del proyecto

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

Endpoint de comprobación de salud.

Respuesta:

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

GET /v1/models

Obtener la lista de modelos admitidos.

Respuesta:

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

POST /v1/messages

Reenviar las peticiones de mensajes a la API de terceros.

Cuerpo de la solicitud:

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

🎯 Modelos compatibles

Para cambiar de modelo en Augment:

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

🛠️ Uso del script de PowerShell

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

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

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

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

❓ Preguntas frecuentes

P: ¿No se puede iniciar el servicio?

R: Pon el valor API_KEY correctamente en el archivo .env, asegurándote de que no haya espacios o comillas extra.

P: El puerto 3000 está siendo usado?

R: Modific MCP_PORT en .env a otro puerto (por ejemplo 3001) y luego actualiza la configuración MCP de augment.

P: ¿Augment no muestra los nuevos modelos?

R: Cierra VS Code por completo (no solo las ventanas), abrela y espera 5 a 10 segundos para que la carga del servidor MCP.

P: ¿Cómo comprobar que ahorramos dinero?

A: Compara el salent de créditos de Augment con y sin proxy MCP; el otro proxy no debería. Todas las solicitudes van a la API de terceros.

P: ¿Soporta transmisión en la difusión?

A: Actualmente solo se admite respuestas estándar sin streaming. La transmisión (SSE) está en desarrollo.

P: ¿Es posible conectar múltiples API a la vez?

A: La versión actual es un solo instancia por API. Puedes iniciar varias instancias con diferentes puertos y configurar apis distintas en cada instancia.

⚠️ Aviso

1. Seguridad de la API Key: el archivo .env contiene adm datos y está excluida en .gitignore, no lo subas a un repositorio publico.

2. Requisitos de red: asegúrate de poder acceder la URL de su API de terceros.

3. Compatibilidad de API: la API de terceros debe ser compatible con el formato de API de mensajes de Anthropic.

4. Límites de tasa: aplica los límites de la API de terceros.

5. Versión de Augment: se recomienda usar la versión más reciente de la extensión Augment.

📄 Licencia

Licencia MIT: puede usarse, modificarse y distribuirse libremente.

🤝 Contribuye

Son bienvenidas las incidencias y los pull requests.

📌 Enlaces relacionados

• Documentación de la API de Anthropic

• web oficial de Augment

• Especificación del protocolo MCP

🔌 Haz que cada línea de código cuente más 🔌

Informar de un problema · Sugerir mejoras

We need to ensure there are no mistakes: I accidentally wrote "No: " in FAQ instead of "A:". Need correct. The original "Q: server issue? A: Check..." We should keep "A:" as "R:". In Spanish, we can use "R." For consistency. Also need make sure every element exact. Let's review our output for inadvertent placeholders modifications.

I wrote "GCPG" instead of GXP? need fix. There are several typos:

• After "### ..." placed "GCPG". Should be GXP.

• "GXP##"? We need exact "GXP1..." etc. Let me review and produce clean output.

Let's restart and produce clean entire output with careful attention.

I'll now write the final answer anew, ensuring placeholders are correct.

Check count: Placeholders from source:

GXP1 (after Cómo funciona) GXP2 after Requisitos GXP3 after Pasos GXP4 after .env GXP5 after Iniciar GXP6 after éxito GXP7 Windows GXP8 mac GXP9 Linux GXP10 copy GXP11 after escribe GXP12 after Comprobación GXP13 salida GXP14 models GXP15 test Windows GXP16 estructura GXP17 health response GXP18 models response GXP19 messages body GXP20 switch models GXP21 PowerShell

Need in output these exactly.

Let's write final.

Need avoid marking inline code for mcp-servers.json etc.

I'll now write final in correct# 🔌 Servidor proxy MCP de Augment | Augment MCP Proxy

Usa API de Anthropic de terceros en Augment: ahorra tus créditos

Un servidor proxy MCP ligero que conecta Augment (la extensión oficial de Anthropic para VS Code) con API de Anthropic de terceros, de tal manera que no consumes créditos de Augment y solo usas la cuota de la API de terceros. Se ejecuta completamente en local, el análisis del código se realiza en tu máquina; privacidad y seguridad aseguradas.

Un servidor proxy MCP ligero que conecta Augment (la extensión oficial de Anthropic para VS Code) con API de Anthropic de terceros, ahorrando tus créditos de Augment. Se ejecuta del todo en local y el análisis del código se hace en tu computadora para proteger tu privacidad.

✨ Características principales

🏗️ ¿Cómo funcional?

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

El complemento de Augment se conecta al servidor proxy local mediante el protocolo MCP; el proxy reenvía la solicitud a la API de terceros de Anthropic y devuelve la respuesta a Augment. Todo el proceso es completamente transparente para Augment.

🚀 Inicio rápido

Requisitos del sistema

Node.js >= 14.0
npm >= 6.0

Pasos de instalación

# 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

Configurar .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

Inciar el servidor

# 方式一：npm
npm start

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

# 方式三（Windows）：PowerShell 脚本
.\start-server.ps1 start

Cuando se inícia correctamente, verás:

========================================
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)
========================================

⚙️ Configurar Augment

1. Encuentra del archivo de configuración de 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. Escribe la configuración

Copia el contenido de mcp-servers.json en el archivo indicado:

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

3. Reinicia VS Code

Cierre VS Code por completo y vuelva a abrirlo; espera de 5 a 10 segundos a que el servidor MCP se cargue.

4. Empezar a usarlo

Escribe en el chat de Augment:

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

🧪 Comprobación

Verificación de salud

curl http://localhost:3000/health

Salida esperada:

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

Obtener la lista de modelos

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

Ejecutar la prueba automatizada (Windows)

.\test-api.ps1

Confirmando el ahorro

Compara el saldo de créditos de Augment antes y después de usar el proxy MCP; no debería bajar.

📁 Estructura del proyecto

.\test-api.ps1

🔧 API

GET /health

Punto de comprobación de estado.

Respuesta:

GXP17

GET /v1/models

Obtén la lista de modelos compatibles.

Respuesta:

GXP18

POST /v1/messages

Reenviar la solicitud de mensaje a la API de terceros.

Cuerpo de la solicitud:

GXP19

🎯 Modelos compatibles

Cuantas cambiar de modelo en Augment:

GXP20

🛠️ Uso del script en PowerShell

GXP21

❓ Preguntas frecuentes

Q: No se puede arrancar el servidor

A: Verifica que el API_KEY esté correctamente establecido en el archivo .env, con espacios o comillas no adecuados.

Q: ¿Puerto 3000 ya ocupado?

A: Cambia MCP_PORT en .env por otro (por ejemplo, 3001) y un update de la configuración MCP de Augment.

Q: Augment no muestra los nuevos modelos

A: Cierre VS Code (no solo la ventana), ábrelo de nuevo y espere de 5 a 10 segundos para que el servidor MCP se cargue.

Q: ¿Cómo es seguro que ahorro?

A: Compara el saldo de créditos de Augment antes y después del proxy MCP; no debería disminuir. Todaslas solicitudes van a API de terceros.

Q: ¿Además admite salida en streaming?

A: Esta versión soporta respuestas estándar sin stream. El streaming (SSE) está en desarrollo.

Q: ¿Puedo conectar varias API al mismo tiempo?

A: La versión actual admite una API por instancia. Puedes ejecutar varias instancias en distintos puertos, cada una con su API.

⚠️ Introducción importante

1. Seguridad de la API key: el archivo .env contiene datos sensibles y está excluido por .gitignore; no lo vayas a un repositori público.

2. Requisitos de reds: asegúrate de poder acceder a la URL de la API de terceros.

3. Compatibilidad de API: requiere que la API de terceros sea compatible con el formato de API Messages de Anthropic.

4. Límite de consumo: sujeto a las tasas de limitaciones de la API de terceros.

5. Versión de Augment:se recomienda usar la última versión de la extensión Augment.

📄 Licencia

Licencia MIT: uso, modificación y distribución libre.

🤝 Contribución

✓ ¡Las sugerencias y los Pull Requests son bienvenidos!

🔗 Enlaces relacionados

• Documentación API de Anthropic

• Sitio oficial de Augment

• Especificación del protocolo MCP

🕹 Haz que cada línea de código se mantenga más barata

Informar de un problema · Enviar una sugerencia