🚀 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 平台的丰富功能相结合，打造一个高效、灵活且安全的工作环境。