Portkey-MCP-Server

Portkey-MCP-Server 是为 Portkey 实现模型上下文协议 (MCP) 的服务器。它作为连接各种 AI 工具和服务的桥梁，支持通过标准协议与多种应用和平台集成。

目录

• 功能特性
• 安装方法
• 配置指南
• 使用说明
• 贡献指南
• 许可证

功能特性

Portkey-MCP-Server 支持以下功能：

1. 协议支持：遵循 MCP 协议，实现工具调用和会话管理。
2. 工具集成：目前支持 prompt_render 工具，用于处理提示模板和变量替换。
3. 多平台兼容性：能够与 Portkey CLI 和 Claude Desktop 等应用无缝集成。

安装方法

使用 Docker 安装

1. 拉取镜像：

   docker pull ericmccaleb/portkey-mcp-server:latest
   

2. 启动容器：

   docker run -it --rm ericmccaleb/portkey-mcp-server:latest
   

使用二进制文件安装

1. 下载适用于目标操作系统的二进制文件。
2. 解压并赋予执行权限：

   unzip portkey-mcp-server.zip && chmod +x portkey-mcp-server
   

3. 执行程序：

   ./portkey-mcp-server
   

配置指南

环境变量配置

运行服务器时，可以通过以下环境变量进行配置：

• PORTKEY_API_KEY：Portkey 平台的 API 访问密钥。
• TRANSPORT：通信方式，可选值为 stdio 或 sae。

示例：

PORTKEY_API_KEY="your-api-key" TRANSPORT="sae" ./portkey-mcp-server

使用说明

通过 Portkey CLI 使用

在 ~/.config/portkey/mcp-servers.json 中添加以下配置：

使用 Docker：

{
  "mcpServers": {
    "Portkey": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "PORTKEY_API_KEY=your-api-key",
        "-e", "TRANSPORT=sae",
        "ericmccaleb/portkey-mcp-server:latest"
      ]
    }
  }
}

使用二进制文件：

{
  "mcpServers": {
    "Portkey": {
      "command": "/path/to/portkey-mcp-server-binary",
      "env": {
        "PORTKEY_API_KEY": "your-api-key",
        "TRANSPORT": "sae"
      }
    }
  }
}

通过 Claude Desktop 使用

Claude Desktop 支持 stdio 模式，配置文件路径如下：

• macOS：~/Library/Application Support/Claude/
• Windows：%APPDATA%\Claude\

示例配置：

{
  "mcpServers": {
    "Portkey": {
      "command": "/path/to/portkey-mcp-server-binary",
      "env": {
        "PORTKEY_API_KEY": "your-api-key",
        "TRANSPORT": "stdio"
      }
    }
  }
}

手动 SSE 请求

在 sae 模式下，可以通过以下步骤进行 HTTP 请求：

1. 建立 SSE 连接：

   curl http://localhost:8080/sae
   

   返回示例：

   event: endpoint
   data: /message?session=abc123
   

2. 发送请求：

   curl -X POST "http://localhost:8080/message" \
     -H "Content-Type: application/json" \
     -d '{"tool":"prompt_render","args":{"template":"hello_world","variables":{"name":"world"}}}'
   

3. 接收响应：

   curl http://localhost:8080/stream?session=abc123
   

贡献指南

欢迎社区贡献代码和文档。请参考 GitHub 仓库 了解具体贡献流程。

许可证

Portkey-MCP-Server 采用 MIT 许可证，详见 LICENSE 文件。