Portkey MCP Server

🚀 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 ファイルを参照してください。