本機跨協定即時轉換
可在本機端即時轉換 OpenAI Responses、Anthropic Messages 與 Gemini 協定。讓相容特定協定的 Agent 工具，直接與其他架構的模型無縫介接。
本地閘道・模型選擇・協定中繼
讓多種 Agent 無縫使用已加入的模型供應商
Magpie 是一款執行於本機的閘道與模型選擇工具。在您的電腦內部無縫轉換 OpenAI Responses、Anthropic Messages 與 Gemini 協定，同時完整保留即時串流輸出、工具呼叫（Tool Calling）與推理過程。
本地流量與協定映射架構
Localhost:8080
請求端
多種 Agent
Coding / 專案 / 助理 Agent
發出協定：OpenAI
本地中繼核心
Magpie 本地閘道
本機即時協定轉換
模型切換與配置保存
智慧路由與故障切換
重用已有訂閱
後端供應商
多種模型供應商
已加入並授權之服務
OpenAI
Anthropic
Google Gemini
Capabilities
核心能力與功能特點
整理自官方公開中文說明，Magpie 聚焦於提供本機模型調度與多協定轉譯的輕量解決方案。
串流、工具呼叫與推理過程
協定轉換過程中不犧牲進階功能特性。完整支援 Server-Sent Events (SSE) 即時串流響應、結構化 Tool Calling（函數調用）以及模型推理思考鏈的逐步還原。
切換 Agent 模型與保存配置
可隨時為不同的 Agent 切換所使用的模型來源，並能將調試好的模型組合與參數存為配置方案，方便針對不同編程專案或研究情境迅速調用。
重用已有訂閱與智能路由
支援重用您在各大供應商已擁有的帳號與訂閱憑證，結合智能路由策略，依據規則將請求導向合適的模型供應商，提升調度彈性。
限額管理與自動故障切換
具備請求限額與故障切換機制（Failover）。當特定供應商發生超額、速率限制或端點服務異常時，系統可切換至備援配置，維護工作流程連續性。
官方說明內容
精準修改設定與金鑰隔離
支援精確修改使用者設定以微調行為。在安全架構方面，官方說明稱：密鑰留在 Magpie、Agent 不會直接看到；且 Magpie 不會讀取 shell 環境變數中的 API key。
※ 提示：此項為官方文檔所載說明，不構成第三方安全保證或審計背書。
How It Works
Magpie 本地閘道工作方式
基於官方公佈之本機架構，以清晰的請求生命週期呈現 Magpie 在本機扮演的中繼樞紐角色。
01
Agent 發送本機請求
Agent（如終端程式碼助手或自訂工具）將其標準 API 請求指向 Magpie 於本地監聽的端點。
02
本機協定轉譯與路由判定
Magpie 解析協定（OpenAI / Anthropic / Gemini），套用使用者設定方案、智能路由原則與限額／故障防護檢查。
03
轉發已授權供應商並串流回傳
調用已加入的模型供應商端點，並將包含 Tool Calling 及推理狀態的即時串流雙向傳回給原 Agent。
關於密鑰儲存與環境變數（官方說明）
官方公開頁面指稱：API 密鑰僅留存於 Magpie 本身，不會直接暴露給運作中的 Agent；此外，Magpie 明確聲明不讀取 shell 環境變數中的 API key。使用者可在 Magpie 內部精準修改設定與配置管理。
Specifications
輕量規格與相容平台
不論在終端腳本或桌面開發環境中，均具備極高的可攜性與彈性。
< 15MB
極輕量單一二進位
不到 15MB 的精巧體積，不依賴龐大繁複的執行時期環境，啟動迅速。
MIT
開放原始碼授權
採用寬鬆友善的 MIT 授權條款開源發布，程式碼公開透明。
3 大系統
跨作業系統支援
全面支援 macOS、Windows 以及 Linux，符合多元本機開發環境。
TUI / CLI
命令列與終端介面
提供 TUI（文字使用者介面）與 CLI 工具，便於終端互動與腳本調度。
重要費用與服務說明
Magpie 本身是一套本機閘道與模型選擇軟體，並不包含或暗示任何免費的模型運算額度。所有透過 Magpie 發送至 OpenAI、Anthropic、Google 等模型供應商之 API 請求費用，均由使用者自行依各供應商官方訂閱及計費條款支付。