🔌 Прокси-сервер Augment MCP | Augment MCP Proxy

Используйте сторонний Anthropic API в Augment — экономьте свои кредиты

Лёгкий прокси-сервер MCP, который подключает Augment (официальное расширение VS Code от Anthropic) к сторонним Anthropic API, поэтому кредиты Augment не расходуются — тратится только квота стороннего API. Полностью работает локально, анализ кода выполняется на вашем компьютере, конфиденциальность обеспечена.

Лёгкий прокси-сервер MCP, который подключает Augment (официальное расширение VS Code от Anthropic) к сторонним Anthropic API, экономя кредиты Augment. Полностью локальный запуск с анализом кода на вашем компьютере для безопасности.

✨ Ключевые преимущества

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, прокси пересылает запросы на сторонний 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

Подтверждение экономии

Сравните баланс кредитов Augment до и после использования MCP-прокси: он не должен уменьшаться.

📁 Структура проекта

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

Пересылка запросов на сторонний API.

Тело запроса:

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

🎯 Поддерживаемые модели

Переключение модели в 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: Проверьте, правильно ли задан API_KEY в файле .env. Убедитесь, что нет лишних пробелов или кавычек.

Q: Порт 3000 уже занят?

A: Измените MCP_PORT в .env на другой порт (например, 3001), затем обновите конфигурацию MCP в Augment.

Q: Augment не видит новые модели?

A: Полностью закройте VS Code (не просто окно), откройте заново и подождите 5–10 секунд, пока загрузится MCP-сервер.

Q: Как убедиться, что я экономлю?

A: Сравните баланс кредитов Augment до и после использования MCP-прокси: он не должен уменьшаться. Все запросы идут через сторонний API.

Q: Поддерживается ли потоковый вывод?

A: Текущая версия поддерживает стандартные не потоковые ответы. Поддержка потокового вывода (SSE) находится в разработке.

Q: Можно ли подключаться к нескольким API одновременно?

A: Текущая версия — один экземпляр для одного API. Можно запустить несколько экземпляров на разных портах и настроить для них разные API.

⚠️ Примечания

1. Безопасность API-ключа: файл .env содержит чувствительную информацию, он уже исключён в .gitignore; не публикуйте его в открытых репозиториях.

2. Сетевые требования: убедитесь, что адрес стороннего API доступен.

3. Совместимость API: сторонний API должен быть совместим с форматом Anthropic Messages API.

4. Лимиты запросов: действуют ограничения скорости стороннего API.

5. Версия Augment: рекомендуется использовать последнюю версию расширения Augment.

Czę

📄 Лицензия

MIT License — можно свободно использовать, изменять и распространять.

Czę

🤝 Вклад

Принимаются Issue и Pull Request'ы!

Czę

📌 Связанные ссылки

• Документация Anthropic API

• Официальный сайт Augment

• Спецификация протокола MCP

🔌 Экономьте с каждой строкой кода 🔌

Сообщить о проблеме · Предложить улучшение