Portkey MCP Server

🚀 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 文件。