Skip to main content
Glama
deenesjakoruzh
Windyhhh

Augment-MCP-Proxy

by Windyhhh
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

🔌 Augment MCP プロキシサーバー | Augment MCP Proxy

Use Third-Party Anthropic API in Augment — Save Your Credits

Augment（Anthropic 公式の VS Code 拡張）をサードパーティーの Anthropic API に接続する軽量 MCP プロキシサーバーです。Augment のクレジットを消費せず、サードパーティーの API クォータのみを消費します。完全にローカルで動作し、コード分析もローカルで行われるため、プライバシーが保護され安全です。

A lightweight MCP proxy server that connects Augment (Anthropic's official VS Code extension) to third-party Anthropic APIs, saving Augment credits. Runs fully locally with code analysis done on your machine for privacy.

✨ 主な特長

特性

説明

💰 コスト削減

Augment のクレジットを消費せず、サードパーティーの API クォータのみを使用

🔄 シームレス統合

Augment の利用体験は完全に変わらず、すべての機能をサポート

🔒 ローカル実行

コード分析はローカルで完了し、ソースコードをアップロードしないため、プライバシーが安全

🤖 マルチモデル対応

Haiku / Sonnet / Opus の 3 モデルを自由に切り替え可能

⚡ 軽量

依存は 2 つだけ（axios + dotenv）、起動は数秒

🪟 クロスプラットフォーム

Windows / macOS / Linux で実行可能

Related MCP server: roblox-mcp-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' Server Code を再起動する

VS Code を完全に閉じてから再度開き、MCP サーバーの読み込みまで 5〜10 秒待ちます。

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

メッセージのリクエストをサードパーティーの 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: .env 内の MCP_PORT を別のポート（例:3001）に変更し、Augment の MCP 設定を更新してください。

Q: Aug に新しいモデルが表示されない？

A: VS Code を完全に閉じて（ウィンドウを閉じるだけではなく）、再度開いて、MCP サーバーの読み込みまで 5〜10 秒以上待ってください。

Q: 削減効果を確認するに は？

A: MCP プロキシ利用前後で Aug のクレジット残高を比較してください。残高は減らないはずです。すべてのリクエストはサードパーティーの 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 プラグインの使用を推奨します。

📄 ライセンス

MIT License — 自由に使用、変更、配布できます。

🤝 コントリビューション

Issue や Pull Request の提出を歓迎します！

📌 関連リンク

🔌 すべてのコードをより経済的に 🔌

問題を報告する · 提案する

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • roblox-mcp-bridge

    kavinr24
    A
    license
    Not graded
    quality
    D
    maintenance
    Connects Roblox Studio to local AI agents via HTTP, allowing them to control Studio tools.
    MIT

  • Coolify AnythingLLM MCP

    xlop-dev
    A
    license
    Not graded
    quality
    D
    maintenance
    Connects AnythingLLM to Coolify for natural language management of self-hosted infrastructure, including diagnostics, log fetching, and deployment automation.
    MIT

  • everos-mcp

    Marvisatron
    A
    license
    A
    quality
    D
    maintenance
    Connects Claude Code to a local EverOS instance for searching and storing long-term memory, keeping data entirely on your machine.
    4
    Apache 2.0