Portkey MCP Server

Portkey MCP 服务

将你的 AI 助手变成 Portkey 平台专家！此 MCP 服务将 Claude 连接到 Portkey 的 API，支持全面管理 AI 配置、工作区、分析数据和用户访问权限。

安装

从源代码安装

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 自动为 Claude Desktop 安装 Portkey MCP 服务：

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

实际应用场景

• “不同模型的当前 API 使用统计数据是多少？”
• “显示我的 AI 部署的性能指标”
• “为团队项目创建一个新工作区”
• “我当前的 API 密钥使用情况和剩余额度是多少？”
• “生成上个月 API 调用的分析报告”
• “为我的开发环境设置速率限制”
• “为我的生产环境端点配置回退行为”
• “将团队成员添加到我的 Portkey 工作区”
• “显示我的 API 调用的延迟统计数据”
• “为我的 API 请求设置自定义标头”

🔑 环境变量

变量	描述
PORTKEY_API_KEY	你的 Portkey API 密钥（必需）

🌟 功能

此 MCP 服务通过以下功能全面支持访问 Portkey 平台：

用户与访问管理

• 用户管理：列出并管理 Portkey 组织中的所有用户
• 用户邀请：使用可自定义的角色和权限邀请新用户
• 工作区访问权限：配置用户在不同工作区中的访问级别
• 基于角色的控制：在组织和工作区级别分配管理员、经理或成员角色

分析与报告

• 使用情况分析：跟踪详细的用户活动和请求模式
• 成本分析：监控并分析不同时间段的成本
• 请求指标：查看请求数、令牌用量和响应时间
• 筛选报告：根据状态码、虚拟密钥和时间范围等自定义条件生成报告

工作区管理

• 工作区概览：列出并查看所有工作区的详细信息
• 配置管理：访问并查看工作区配置
• 虚拟密钥管理：监控并管理具有用量限额和速率限制的 API 密钥
• 工作区设置：查看并跟踪工作区元数据和用户关联信息

配置与 API 设置

• 配置列表：查看组织中所有可用的配置
• 配置详细信息：访问缓存设置、重试策略和路由策略
• 虚拟密钥详情：监控密钥状态、用量限额和速率限制
• API 集成：跟踪 API 端点及其配置

许可证

此项目采用 ISC License 许可，详情请参阅 LICENSE 文件