SMCP Proxy (OIDC)

SMCP Proxy是一個為Model Context Protocol (MCP)服務設計的反向代理，提供OIDC認證的安全層，支持企業級認證和授權，簡化與大型語言模型(LLM)的標準化交互。

安全開發者工具 .Go

評分 : 2.5分

下載量 : 9.3K

更新時間 : 2025-05-07

打開站點

什麼是SMCP Proxy？

SMCP Proxy 是一個安全的反向代理，用於標準化的人工智能應用上下文協議（MCP）。它通過支持OIDC認證為企業級用戶提供安全訪問，使MCP服務更易於在企業環境中擴展。

如何使用SMCP Proxy？

SMCP Proxy 包含兩個組件：代理服務器和代理客戶端。您可以輕鬆配置這些組件來實現安全的MCP服務連接。

適用場景

SMCP Proxy 適用於需要對AI模型進行集中管理的企業環境，特別是那些希望確保安全性和可擴展性的組織。

主要功能

身份驗證

支持無認證和OIDC兩種模式，確保請求的安全性。

多後端支持

可以配置多個MCP後端，並根據請求路徑自動路由。

安全路由

通過路徑前綴剝離等功能優化請求路由。

模型發現API

提供API接口以列出可用的MCP模型。

優勢

支持多種認證方式，包括OIDC。

強大的路徑路由功能。

支持多後端配置。

易於擴展和部署。

內置健康檢查機制。

侷限性

需要一定的技術背景進行初始配置。

某些高級功能可能需要自定義配置。

本地運行時需要Docker支持。

如何使用

安裝SMCP Proxy

下載並編譯SMCP Proxy代碼，或者直接拉取Docker鏡像。

配置代理服務器

編輯配置文件（如proxy-server.yml），設置後端服務器和認證選項。

啟動代理服務器

運行代理服務器，監聽指定端口。

啟動代理客戶端

啟動客戶端以代理應用程序請求到服務器。

使用案例

使用默認配置啟動服務器

使用默認配置啟動代理服務器。

啟用OIDC認證

配置代理服務器以啟用OIDC認證。

常見問題

如何配置多個MCP後端？

如何啟用OIDC認證？

如何檢查代理服務器的健康狀態？

🚀 SMCP 代理指南

SMCP 代理是一個支持多種模型服務協議的中間件，允許用戶通過統一接口訪問不同後端服務，為用戶提供便捷的服務調用體驗。

🚀 快速開始

SMCP 代理是一個支持多種模型服務協議的中間件，允許用戶通過統一接口訪問不同後端服務。以下是基本使用示例：

示例配置 (proxy-server.yml)

global:
  port: 8080
  host: "localhost"
  log_level: "info"
  enable_metrics: true

backends:
  mcp-sequential:
    url: "http://localhost:3001/api"
    strip_path: "/v1/sequentialthinking"

  mcp-memory:
    command: "docker"
    args:
      - run
      - --rm
      - -i
      - mcr.microsoft.com/hugginginception/transformers Glenn Glock/llama2-70b-instruct

✨ 主要特性

高可用性：支持負載均衡和故障轉移。
可擴展性：便於添加新的後端服務。
高性能：通過中間件優化請求處理。

📦 安裝指南

從源碼安裝

克隆倉庫：

git clone git@github.com:yourusername/smc-proxy.git
cd smc-proxy

下載依賴並構建：

go mod tidy
go build -o bin/smc cmd/sm/main.go

sudo cp bin/smc /usr/local/bin/

從二進制文件安裝

下載預編譯的二進制文件，根據你的操作系統選擇對應的版本。

💻 使用示例

基礎用法

場景一：統一接口訪問多後端

curl http://localhost:8080/api/prompt \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-3.5-turbo", "messages":[{"role":"user","content":"你好！"}]}'

場景二：集成到現有系統

package main

import (
    "net/http"
)

func main() {
    http.ListenAndServe(":8081", smc.NewRouter())
}

高級用法

這裡可以根據實際的高級使用場景進行補充說明，如果沒有則可忽略。

📚 詳細文檔

配置參考

全局配置

參數名	類型	默認值	描述
port	int	8080	代理服務器監聽端口
host	string	"localhost"	監聽地址
log_level	string	"info"	日誌級別：debug, info, warning, error
enable_metrics	bool	false	是否啟用 metrics

後端配置

支持兩種類型的後端：

HTTP 類型：

backend_name:
  transport: "http"
  url: "http://example.com/mcp"

Stdio 類型：

backend_name:
  transport: "stdio"
  command: "docker"
  args:
    - run
    - --rm
    - -i
    - your/image:tag

模型服務協議

基本請求格式

POST /api/prompt HTTP/1.1
Content-Type: application/json

{
  "model": "gpt-3.5-turbo",
  "messages": [
    {
      "role": "user",
      "content": "你好！"
    }
  ]
}

返回格式

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "chatcmpl-XXXXX",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "你好！很高興見到你。"
      }
    }
  ]
}

🔧 技術細節

項目結構

smc-proxy/
├── cmd/
│   └── sm/                # 主程序入口
│       ├── main.go        # 入口文件
│       └── config.go      # 配置加載邏輯
├── internal/
│   ├── middleware/       # 中間件實現
│   │   ├── log.go        # 日誌記錄中間件
│   │   └── recovery.go   # 錯誤恢復中間件
├── go.mod                # 依賴管理文件
└── go.sum                # 依賴校驗文件

中間件

日誌記錄

在每個請求開始時記錄日誌：

func LogMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        log.Printf("Started %s %s", r.Method, r.URL.Path)
        next(w, r)
    }
}

錯誤恢復

處理panic並返回自定義錯誤：

func RecoveryMiddleware(next http.HandlerFunc) http.HandlerFunc {
    panicChan := make(chan interface{}, 1)
    go func() {
        defer func() { recover }()
        next(nil, nil)
    }()
    select {
    case <-panicChan:
        // 處理panic信息
    }
}