🔌 Augment MCP-Proxy-Server | Augment MCP Proxy

Nutze die Drittanbieter-Anthropic-API in Augment – spare deine Credits

Ein schlanker MCP-Proxy-Server, der Augment (die offizielle VS-Code-Erweiterung von Anthropic) mit einer Drittanbieter-Anthropic-API verbindet und dabei keine Augment-Credits verbraucht, sondern nur das API-Kontingent des Drittanbieters. Läuft vollständig lokal, die Code-Analyse findet auf deinem Rechner statt – Datenschutz bleibt gewahrt.

Ein leichtgewichtiger MCP-Proxy-Server, der Augment (Anthropics offizielle VS-Code-Erweiterung) mit Drittanbieter-Anthropic-APIs verbindet, spart Augment-Credits. Läuft vollständig lokal; die Code-Analyse erfolgt auf deinem Rechner und deine Daten bleiben privat.

✨ Kernfunktionen

Related MCP server: LiteLLM MCP Server Bridge

🏗️ Funktionsweise

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

Augment verbindet sich über das MCP-Protokoll mit dem lokalen Proxy-Server. Der Proxy leitet die Anfrage an die Drittanbieter-Anthropic-API weiter und gibt die Antwort an Augment zurück. Der gesamte Vorgang ist für Augment vollständig transparent.

🚀 Schnellstart

Umgebungsanforderungen

Node.js >= 14.0
npm >= 6.0

Installationsschritte

# 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 konfigurieren

# 第三方 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

Server starten

# 方式一：npm
npm start

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

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

Nach erfolgreichem Start erscheint:

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

1. MCP-Konfigurationsdatei finden

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. Konfiguration eintragen

Kopiere den Inhalt von mcp-servers.json in die oben genannte Datei:

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

3. VS Code neu starten

Schließe VS Code vollständig und öffne es erneut. Warte 5–10 Sekunden, bis der MCP-Server geladen ist.

4. Verwenden

Gib im Augment-Chat ein:

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

🧪 Tests & Verifikation

🔍 Health-Check

curl http://localhost:3000/health

Erwartete Ausgabe:

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

📋 Liste der Modelle abrufen

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

▶️ Testskript ausführen (Windows)

.\test-api.ps1

✅ Spareffekt bestätigen

Vergleiche den Augment-Creditstand vor und nach der Nutzung des MCP-Proxys – er sollte nicht abnehmen.

📁 Projektstruktur

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-Endpunkte

GET /health

Health-Check-Endpoint.

Antwort:

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

GET /v1/models

Liefert die Liste der unterstützten Modelle.

Antwort:

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

POST /v1/messages

Leitet Nachrichten-Anfragen an die Drittanbieter-API weiter.

Anfragekörper:

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

🎯 Unterstützte Modelle

In Augment das Modell wechseln:

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

🛠️ PowerShell-Skriptverwendung

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

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

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

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

❓ Häufig gestellte Fragen

Q: Der Server startet nicht?

A: Prüfe, ob der API_KEY in der .env-Datei korrekt gesetzt ist, und stelle sicher, dass keine überflüssigen Leerzeichen oder Anführungszeichen vorhanden sind.

Q: Port 3000 ist bereits belegt?

A: Ändere MCP_PORT in .env auf einen anderen Port (z. B. 3001) und aktualisiere anschließend die MCP-Konfiguration für Augment.

Q: Augment zeigt die neuen Modelle nicht an?

A: Schließe VS Code vollständig (nicht nur das Fenster) und öffne es erneut. Warte 5–10 Sekunden, bis der MCP-Server geladen ist.

Q: Wie kann ich sicher sein, dass ich Credits spare?

A: Vergleiche den Creditstand von Augment vor und nach der Nutzung des MCP-Proxys – der Stand sollte nicht abnehmen. Alle Anfragen laufen über die Drittanbieter-API.

Q: Unterstützt es Streaming-Ausgabe?

A: Die aktuelle Version unterstützt die standardmäßige Nicht-Streaming-Ausgabe. Streaming-Ausgabe (SSE) ist in Entwicklung.

Q: Kann ich mehrere APIs gleichzeitig verbinden?

A: Die aktuelle Version unterstützt eine Instanz für eine API. Du kannst mehrere Instanzen mit verschiedenen Ports starten und jeweils eine andere API konfigurieren.

⚠️ Wichtiger Hinweis

1. API-Schlüssel-Sicherheit: Die .env-Datei enthält sensible Informationen und wurde in .gitignore aufgenommen. Nicht in öffentliche Repositorys committen.

2. Netzwerk-Anforderungen: Stelle sicher, dass die Drittanbieter-API-Adresse erreichbar ist.

3. API-Kompatibilität: Die Drittanbieter-API muss dem Anthropic-Messages-API-Format entsprechen.

4. Ratenbegrenzung: Unterliegt den Ratenbegrenzungen der Drittanbieter-API.

5. Augment-Version: Es wird empfohlen, die neueste Augment-Erweiterung zu verwenden.

📄 Lizenz

MIT-Lizenz – frei verwendbar, veränderbar und weitergebbar.

🤝 Mitwirken

Feedback und Pull-Requests sind willkommen!

📌 Weitere Links

• Anthropic-Dokumentation

• Augment-Website

• MCP-Protokollspezifikation

🔌 Jede Zeile Code spart Geld 🔌

Problem melden · Vorschlag einreichen