Portkey Admin MCP Server

Portkey 管理 MCP 服务

Portkey 管理 API，作为 MCP 服务提供——涵盖提示词、配置、密钥、分析、治理、部署等领域的 194 个工具。

重要

正在积极开展兼容性开发。 Palo Alto Networks 于 2026‑05‑29 完成对 Portkey 的收购，并将 Portkey 定位为 Prisma AIRS AI Gateway 的核心。Portkey 管理 API 仍在运行，其官方 OpenAPI 和产品更新日志截至 2026 年 10 月仍在持续新增控制平面功能，因此本项目已恢复 API 覆盖工作。本项目面向兼容 Portkey 的 API（x-portkey-api-key），而非直接面向 Prisma AIRS/Strata Cloud Manager。Palo Alto 现已发布 Prisma AIRS 管理规范，但其使用不同的身份验证方式、多个管理基础 URL，且涵盖的领域更少，因此不能直接替换 PORTKEY_BASE_URL。有关支持的并行模型和适配器标准，请参阅简短的 Prisma AIRS 互操作指南。

目录

文档

快速入门

你需要一个具有适当权限范围的 Portkey API 密钥。请在 Portkey 控制台的 API Keys 页面获取。

版本 0.15.0 使用 MCP SDK v2，并在同一端点提供协议修订版 2026-07-28 及更早版本的 客户端支持。此版本不再支持 HTTP 会话和重放功能； 过时的设置会发出警告并被忽略。从 0.14.x 升级前，请参阅 兼容性与弃用项。

Claude Code

claude mcp add -e PORTKEY_API_KEY=your_key portkey-admin -- npx -y portkey-admin-mcp

Cursor / Windsurf / VS Code

将以下内容添加到你的 MCP 配置（.cursor/mcp.json、.windsurf/mcp.json 或 .vscode/mcp.json）：

{
  "mcpServers": {
    "portkey-admin": {
      "command": "npx",
      "args": ["-y", "portkey-admin-mcp"],
      "env": {
        "PORTKEY_API_KEY": "your_api_key"
      }
    }
  }
}

直接运行

PORTKEY_API_KEY=your_key npx -y portkey-admin-mcp

如需在 stdio 客户端中仅开放一部分特定工具，请设置 PORTKEY_TOOL_DOMAINS：

PORTKEY_API_KEY=your_key \
PORTKEY_TOOL_DOMAINS=prompts,analytics \
npx -y portkey-admin-mcp

限定域不仅能控制访问权限，也是降低上下文成本的最有效方式。tools/list 采用分页方式；客户端遍历所有页面并跟进 nextCursor 后，完整的 194 个工具目录约为 400 KB。将范围缩小到客户端实际需要的域，可以按大致相同比例减少数据量。

git clone https://github.com/CodesWhat/portkey-admin-mcp.git
cd portkey-admin-mcp
npm install && npm run build

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

你可以做什么

22 个工具域中共有 194 个工具。 完整列表及说明请参见 ENDPOINTS.md。

Portkey 的新产品术语日益倾向于将提供商凭据称为 Providers，但当前 Admin API 仍同时提供 /virtual-keys 和 /providers。此服务保留这两个域：Virtual Keys 用于管理提供商访问凭据，Providers 用于管理工作区提供商配置。

API 密钥权限范围

大多数工具都可以使用启用了 Select All 权限的工作区范围服务密钥。该密钥适用于提示词、配置、虚拟密钥/API 密钥、提供商、防护措施、工作区集成、MCP 服务、速率/用量限制、日志、提示词补全以及工作区用户管理。

如果工具返回 Portkey 错误 AB03，并带有 403 状态码，这意味着缺少权限范围，而不是端点故障。

HTTP 服务（实验性）

状态：HTTP 传输可在本地运行，并由集成测试套件覆盖，但它只是概念验证——此服务没有托管版本，目前也不以托管部署为目标。请使用 stdio（npx）这一受支持的传输方式。

该服务支持 Streamable HTTP，以便远程访问：

HTTP 身份验证用于控制对服务的访问，但不会模拟独立的 Portkey 租户。所有通过身份验证的主体都会使用相同的已配置 PORTKEY_API_KEY，并可调用该凭据授权的任何已启用工具和范围。对于不同信任级别，请使用范围各不相同的 Portkey 凭据和 PORTKEY_TOOL_DOMAINS 允许列表，运行独立实例或部署。

PORTKEY_API_KEY=your_key \
MCP_HOST=127.0.0.1 \
MCP_PORT=3000 \
MCP_PUBLIC_BASE_URL=https://mcp.example.com \
MCP_AUTH_MODE=bearer \
MCP_AUTH_TOKEN=your_secret \
node build/server.js

也可以通过 npx 运行（portkey-admin-mcp 软件包包含 HTTP 二进制文件）：

PORTKEY_API_KEY=your_key MCP_AUTH_MODE=bearer MCP_AUTH_TOKEN=your_secret \
  npx -y -p portkey-admin-mcp portkey-admin-mcp-http

仅在本地使用 HTTP 时，请将 MCP_HOST 保持为默认值 127.0.0.1。只有在确实需要接受来自本机以外的连接时（例如 Docker 或其他网络接口上的反向代理），才设置 MCP_HOST=0.0.0.0。

docker build -t portkey-admin-mcp .
docker run \
  -e PORTKEY_API_KEY=your_key \
  -e MCP_TRANSPORT=http \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=3000 \
  -e MCP_AUTH_MODE=bearer \
  -e MCP_AUTH_TOKEN=your_secret \
  -e RATE_LIMIT_SINGLE_PROCESS=true \
  -p 3000:3000 \
  portkey-admin-mcp

健康检查端点

开发

npm run dev           # stdio with hot reload
npm run dev:http      # HTTP with hot reload
npm test              # unit + contract tests
npm run test:coverage # unit + contract tests with the enforced 80% line floor
npm run test:e2e      # MCP protocol tests
npm run test:http     # HTTP endpoint smoke test
npm run smoke         # credentialed read-only Portkey API smoke suite
npm run ci            # full pipeline (lint + typecheck + coverage + build + e2e + verify)

实时冒烟测试套件会将预期的凭据范围拒绝，以及明确跟踪的托管控制平面路由缺口报告为跳过项。意外的 HTTP 响应、网络错误和响应契约失败仍会导致运行失败。

list_audit_logs 仅限 Enterprise 使用，因此除非设置了 PORTKEY_ORGANISATION_ID，否则冒烟测试套件会跳过对此路由的检查。将其设置为你的组织 ID，即可测试该路由。

必需的 CI 和发布门禁会检测每个 TypeScript 源文件，并在行覆盖率低于 80% 时失败。CI 和 Coverage 工作流报告会显示当前的行、分支和函数覆盖率。

CI 工作流 还会运行独立的 Qlty CLI，并为每次分析的提交发布 quality-reports 工件，其中包括 lint/安全结果、重复代码、复杂度和各项指标。现有的 Qlty 可维护性和覆盖率徽章仍由 Cloud 生成；本地分析不会更新这些徽章。覆盖率上传和 Cloud 分析仍会消耗 Qlty 分析时长。

npm run dev:http 现在默认要求设置 MCP_AUTH_MODE=bearer 或 MCP_AUTH_MODE=clerk。如需有意进行仅限本地的无身份验证测试，请设置 MCP_ALLOW_UNAUTHENTICATED_HTTP=true。

贡献请通过拉取请求进行，并遵循 CONTRIBUTING.md 中记录的检查要求。项目决策和维护者职责记录在 GOVERNANCE.md 中。请通过 SECURITY.md 报告漏洞；有关公开威胁模型和保障说明，请参阅 SECURITY-ASSURANCE.md。

路线图

0.15.0 版本升级至 MCP SDK v2 和 2026-07-28 规范。 路线图 将已完成的工作与上游契约和租户验证门禁区分开来。MCP v2 迁移已在 0.15.0 中发布，旧版客户端仍可使用同一端点，同时会弃用会话和重放存储。请参阅兼容性和弃用事项。

社区

问题和错误报告请提交至 Issues；更广泛的讨论、想法以及有关使用该服务的帮助，请前往 Discussions。 维护中的软件包、注册表、市场和目录记录见 发行版与目录。当第三方索引更新滞后时，请以本仓库中生成的 工具目录为准。

构建所用技术

在 LobeHub 和 Glama 上架：

---

MIT 许可证 · 灵感来自 r-huijts/portkey-admin-mcp-server

返回顶部