Portkey Admin MCP Server

🚀 Portkey MCP 服務器

將您的 AI 助手轉變為 Portkey 平臺專家！此 MCP 服務器連接 Claude 和 Portkey 的 API，實現對 AI 配置、工作區、分析和用戶訪問的全面管理。

🚀 快速開始

此 MCP 服務器為 Claude 提供了強大的擴展能力，使其能夠無縫連接到 Portkey 平臺。通過配置環境變量並按照指南進行設置，您可以輕鬆地將 Claude 集成到您的 Portkey 工作流中。

✨ 主要特性

此 MCP 服務器通過以下功能為您提供對 Portkey 平臺的全面訪問：

用戶與訪問管理

• 用戶管理：列出並管理您組織中的所有用戶
• 用戶邀請：邀請新用戶，帶有可自定義的角色和權限
• 工作區訪問控制：配置不同工作區的用戶訪問級別
• 基於角色的控制：在組織和工作區層面分配管理員、經理或成員角色

分析與報告

• 使用分析：跟蹤詳細的用戶活動和請求模式
• 成本分析：監控並分析不同時期的成本
• 請求指標：查看請求數量、令牌使用情況和響應時間
• 過濾報告：根據自定義標準生成報告，例如狀態碼、虛擬密鑰和時間段

工作區管理

• 工作區概覽：列出並查看所有工作區的詳細信息
• 工作區模板：配置工作區以滿足特定需求
• 資源分配：在不同工作區之間分配資源
• 工作區監控：即時監控工作區的性能和使用情況

配置與管理

• 全局設置：管理組織範圍內的默認設置和策略
• 日誌記錄：捕獲和分析平臺活動的日誌
• 安全控制：實施身份驗證、授權和加密措施
• 集成與擴展：與其他工具和服務進行集成，擴展功能

📦 安裝指南

從源碼安裝

1. 克隆此倉庫
2. 安裝依賴項：

npm install

3. 複製示例環境文件：

cp .env.example .env

4. 將您的 Portkey API 密鑰添加到 .env 文件中：

PORTKEY_API_KEY=your_portkey_api_key_here

5. 然後更新您的 Claude 配置文件：

{
  "mcpServers": {
    "portkey-server": {
      "command": "node",
      "args": [
        "/path/to/portkey-server/build/index.js"
      ],
      "env": {
        "PORTKEY_API_KEY": "your_portkey_api_key_here"
      }
    }
  }
}

請確保：

• 將 /path/to/portkey-server 替換為您實際的安裝路徑
• 在 env 部分添加您的 Portkey API 密鑰

更新配置後，重啟 Claude Desktop 以應用更改。

使用 Smithery 安裝

要通過 Smithery 自動安裝 Portkey MCP 服務器：

npx -y @smithery/cli install @r-huijts/portkey-admin-mcp-server --client claude

💻 使用示例

實際應用場景

• “顯示我當前的 API 使用統計信息？”
• “展示不同模型的性能指標”
• “創建新團隊項目的.workspace”
• “顯示我的當前 API 密鑰使用情況和剩餘額度？”
• “生成上個月 API 調用的分析報告”
• “為我的開發環境設置速率限制”
• “配置生產端點的備用行為”
• “添加團隊成員到我的 Portkey 工作區”
• “顯示我的 API 調用延遲統計信息”
• “為我的 API 請求設置自定義頭”

示例配置

以下是一個典型的 .env 文件示例：

PORTKEY_API_KEY=your_portkey_api_key_here

然後在 package.json 中添加 MCP 服務器的啟動腳本：

{
  "scripts": {
    "start": "node build/index.js"
  }
}

運行服務器：

npm start

📚 詳細文檔

🔑 環境變量

注意事項

⚠️ 重要提示

確保 API 密鑰的安全性，避免洩露。

💡 使用建議

定期檢查更新以保持最佳性能和安全性；參考完整的文檔以瞭解所有功能和配置選項。

通過此 MCP 服務器，您可以將 Claude 的強大能力與 Portkey 平臺的豐富功能相結合，打造一個高效、靈活且安全的工作環境。