Skip to main content
Glama
deenesjakoruzh
s-b-e-n-s-o-n

portkey-admin-mcp

by s-b-e-n-s-o-n
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

Portkey 管理 MCP 服务器

用于 Portkey 管理 API 的 MCP 服务器。可从任何 MCP 客户端管理提示词 (Prompts)、配置、分析、API 密钥等。

快速开始

你需要一个具有适当权限范围的 Portkey API 密钥。请从你的 Portkey 仪表板 的 API Keys 部分获取。

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
git clone https://github.com/s-b-e-n-s-o-n/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"
      }
    }
  }
}

你可以做什么

类别

工具数量

示例

提示词 (Prompts)

14

创建、版本控制、渲染、执行、迁移、推广提示词

提示词片段 (Prompt Partials)

7

带有版本控制的可重用提示词片段

提示词标签 (Prompt Labels)

5

组织提示词版本（生产、预发布、开发）

配置 (Configs)

6

网关路由、缓存、重试、负载均衡

API 密钥 (API Keys)

5

创建和管理受限 API 密钥

虚拟密钥 (Virtual Keys)

5

管理提供商访问密钥

集合 (Collections)

5

按应用或项目对提示词进行分组

提供商 (Providers)

5

管理 AI 提供商配置

集成 (Integrations)

10

提供商集成、模型、工作区访问

MCP 集成 (MCP Integrations)

10

外部 MCP 工具集成

MCP 服务器 (MCP Servers)

10

MCP 服务器注册表和功能

护栏 (Guardrails)

5

内容安全策略

使用限制 (Usage Limits)

7

成本和 Token 消耗限制

速率限制 (Rate Limits)

5

请求频率控制

分析 (Analytics)

20

成本、延迟、错误、Token、缓存、反馈

日志 (Logging)

8

日志摄取和导出

追踪 (Tracing)

3

反馈和追踪检索

用户与工作区 (Users & Workspaces)

20

用户管理、邀请、工作区成员

审计 (Audit)

1

审计日志访问

总计 151 个工具。 请参阅 ENDPOINTS.md 获取包含描述的完整列表。

API 密钥权限范围

不同的工具需要不同的 API 密钥权限范围。对于大多数操作，具有广泛权限的工作区级服务密钥即可。某些功能需要额外的访问权限：

功能

要求

分析、日志导出、审计日志

企业版计划 + analytics.view 权限范围

用户管理、邀请

组织级 API 密钥

集成模型/工作区

组织级 API 密钥

提示词补全

completions.write 权限范围 + 计费元数据

如果工具返回 403 错误且 Portkey 错误代码为 AB03，则表示缺少权限范围，而非端点故障。

HTTP 服务器（实验性）

状态：HTTP 传输功能可用，但托管部署尚未针对生产环境进行全面验证。建议使用 stdio (npx) 以获得可靠的操作。

服务器支持用于远程访问的可流式 HTTP：

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。

配置

变量

默认值

描述

PORTKEY_API_KEY

(必填)

你的 Portkey API 密钥

MCP_HOST

127.0.0.1

绑定地址

MCP_PORT

3000

端口

MCP_PUBLIC_BASE_URL

—

用于 /auth/info 和状态页面的公共绝对基准 URL；建议用于托管部署

MCP_AUTH_MODE

none

none、bearer 或 clerk（除非明确覆盖，否则 HTTP 模式下 none 被禁用）

MCP_AUTH_TOKEN

—

Bearer 认证的密钥

MCP_ALLOW_UNAUTHENTICATED_HTTP

—

仅在有意进行本地未认证 HTTP 调试时设置为 true

MCP_SESSION_MODE

stateful

stateful 或 stateless

MCP_MAX_SESSIONS

100

在拒绝新的初始化请求之前，最大并发有状态 MCP 会话数

MCP_EVENT_STORE

off

off、memory 或 redis

MCP_REDIS_URL

—

用于共享事件存储的 Redis URL

MCP_TLS_KEY_PATH

—

原生 HTTPS 的 TLS 密钥

MCP_TLS_CERT_PATH

—

原生 HTTPS 的 TLS 证书

ALLOWED_ORIGINS

—

CORS 允许列表

MCP_TRUST_PROXY

false

信任代理标头（用于反向代理）

RATE_LIMIT_MAX_BUCKETS

10000

在新客户端共享溢出桶之前，内存中最大不同的速率限制桶数

包含实验性的 Vercel 支持。请参阅 docs/VERCEL_DEPLOYMENT.md 获取设置说明。

要点：

  • 使用带有 Redis 事件存储的无状态模式

  • 需要 Clerk 或 Bearer 认证

  • 保持 MCP_TLS_* 未设置（Vercel 会终止 HTTPS）

  • 将 MCP_PUBLIC_BASE_URL 设置为你的部署 URL，以便通告的 MCP 端点永远不依赖于请求标头

  • Vercel 不支持 WebSocket — 仅支持可流式 HTTP/SSE

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

健康检查端点

路径

用途

GET /health

服务器存活状态

GET /ready

就绪状态（包含可选的 Portkey 连接检查）

GET /auth/info

认证配置元数据

开发

npm run dev           # stdio with hot reload
npm run dev:http      # HTTP with hot reload
npm test              # unit + contract tests
npm run test:e2e      # MCP protocol tests
npm run test:http     # HTTP endpoint smoke test
npm run ci            # full pipeline (lint + typecheck + test + build + e2e + verify)

npm run dev:http 现在默认需要 MCP_AUTH_MODE=bearer 或 MCP_AUTH_MODE=clerk。如需进行故意的本地未认证测试，请设置 MCP_ALLOW_UNAUTHENTICATED_HTTP=true。

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

↑ 回到顶部

Install Server
A
security – no known vulnerabilities
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/s-b-e-n-s-o-n/portkey-admin-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server