styx-mcp-server について
styx-mcp-serverは、MCPクライアントをセルフホストのStyxゲートウェイに接続し、OpenAI、Anthropic、Google、MistralへのAIリクエストを振り分けます。モデル選択、プロジェクトやキーの管理、利用状況の確認ツールも提供します。
主な機能
- 01Styx経由のリクエスト振り分け
- 02モデルと料金の一覧表示
- 03デフォルトモデルの選択
- 04プロジェクトとAPIキーの管理
- 05利用状況とコストの確認
- 06プロバイダーキーの管理
活用シーン
- 01Styxの単一エンドポイント経由でAIリクエストを送信
- 02利用可能なモデルと料金を確認
- 03プロジェクトの作成とAPIキーの管理
- 04利用状況とコストの統計を確認
MCP 対応
MCPクライアントにStyxのリクエスト振り分けとゲートウェイ管理ツールを公開します。通常の起動方法に加え、SSEトランスポートにも対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y styx-mcp-serverSTYX_API_KEYシークレットStyx API key for routing AI requests through the gateway (required for styx_send_request)STYX_TOKENシークレットStyx auth token for project and key management (required for management tools)STYX_API_URLStyx backend API URLSTYX_PROXY_URLStyx proxy URL for AI request routingローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
styx-mcp-server
Styx 用の MCP サーバーです。単一のエンドポイントから OpenAI、Anthropic、Google、Mistral へのリクエストをルーティングする、インテリジェントな AI ゲートウェイです。
Claude Code、Cursor、Windsurf、または MCP 互換のクライアントを、セルフホストした Styx インスタンスに接続できます。
クイックスタート
# Add to Claude Code
claude mcp add styx -- npx styx-mcp-server
# Or run directly
npx styx-mcp-server
必要条件
- Node.js 18+
- 依存関係を含む Python 3.10+:
pip install mcp[cli] httpx pydantic
設定
起動前に環境変数を設定します:
| 変数 | デフォルト | 説明 |
|---|---|---|
STYX_API_URL | http://localhost:8000 | Styx バックエンドの URL |
STYX_PROXY_URL | http://localhost:8080 | Styx プロキシの URL |
STYX_API_KEY | — | API キー(styx_send_request 用) |
STYX_TOKEN | — | 認証トークン(プロジェクト/キーの管理用) |
Claude Code の設定
.claude/mcp.json に追加します:
{
"mcpServers": {
"styx": {
"command": "npx",
"args": ["styx-mcp-server"],
"env": {
"STYX_API_URL": "http://localhost:8000",
"STYX_PROXY_URL": "http://localhost:8080",
"STYX_API_KEY": "sk-styx-...",
"STYX_TOKEN": "your-token"
}
}
}
}
ツール
| ツール | 説明 |
|---|---|
styx_send_request | ゲートウェイ経由で AI リクエストをルーティングします |
styx_list_models | 料金とともに利用可能なモデルをすべて一覧表示します |
styx_switch_model | デフォルトのモデルを設定します |
styx_list_projects | プロジェクトを一覧表示します |
styx_create_project | 新しいプロジェクトを作成します |
styx_list_api_keys | API キーを一覧表示します |
styx_create_api_key | API キーを作成します |
styx_check_usage | 使用状況と費用の統計を確認します |
styx_manage_providers | BYOK プロバイダーキーを管理します |
SSE トランスポート
npx styx-mcp-server --sse # starts on port 8090
ライセンス
Apache-2.0
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。