🚀 Portkey-MCP-Server

Portkey-MCP-Server 是为 Portkey 实现模型上下文协议 (MCP) 的服务器，它就像一座桥梁，连接着各种 AI 工具和服务，支持通过标准协议与多种应用和平台集成，极大地提升了 AI 工具的使用便捷性和通用性。

🚀 快速开始

Portkey-MCP-Server 作为连接各类 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 文件。