Portkey Admin MCP

端口密钥管理MCP服务器

MCP服务器 门钥匙 API管理员。管理任何MCP客户端的提示、配置、分析、API密钥等。

______________________________________________________________________

快速开始

你需要一个 端口密钥API密钥 具有适当的范围。从你的 Portkey仪表板 API密钥下。

克劳德代码

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

光标/风帆/VS代码

添加到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

Build from source

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"
      }
    }
  }
}

______________________________________________________________________

你能做什么

总共150个工具。 看 ENDPOINTS.md 查看带有描述的完整列表。

______________________________________________________________________

API关键范围

大多数工具都与 工作区范围的服务密钥 已启用“全选”权限。其中包括提示、配置、虚拟/API密钥、提供程序、护栏、工作区集成、MCP服务器、速率/使用限制、日志、提示完成和工作区用户管理。

企业门控工具（28）

以下工具需要 仅在Portkey Enterprise计划中可用的组织级范围他们回来了 403 You do not have enough permissions to execute this request 关于工作空间规划。他们的描述包括 Enterprise-gated. Returns 403 on non-Enterprise Portkey plans. 后缀，以便MCP客户提前知道。

其他范围要求

如果工具返回 403 Portkey错误 AB03，这意味着缺少作用域，而不是一个损坏的端点。

______________________________________________________________________

HTTP服务器（实验）

状态：HTTP传输有效，但托管部署未完全验证用于生产。使用stdio（npx）进行可靠操作。

服务器支持Streamable 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.Set MCP_HOST=0.0.0.0 只有当你有意需要接受来自本地机器外部的连接时，比如Docker或另一个接口上的反向代理。

配置

Vercel deployment

包括实验性Vercel支持。看 docs/VERCEL_DEPLOYMENT.md 有关设置说明。

要点：

• 使用Redis事件存储的无状态模式
• 需要职员或持有人身份验证
• 离开 MCP_TLS_* unset（Vercel终止HTTPS）
• 集 MCP_PUBLIC_BASE_URL 到您的部署URL，这样通告的MCP端点就永远不会依赖于请求标头
• Vercel不支持WebSockets——仅支持流式HTTP/SSE

Docker

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

健康终点

______________________________________________________________________

发展

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管理mcp服务器

↑ 返回页首