Superargs

🚀 スーパーパラメータ：チャットでMCPサーバーのパラメータを更新

スーパーパラメータ（Superargs） は、MCPサーバーのパラメータを実行時に設定できるようにします。初期設定時ではなく、アシスタントとの対話中に任意のMCPサーバーにパラメータを提供できます。認証トークン、環境変数、その他のCLIパラメータなど、スーパーパラメータを使用することで、実行時に簡単にパラメータを提供できます。

スーパーパラメータは、superinterface.ai、supermachine.ai、supercorp.aiによってサポートされています。

🚀 クイックスタート

✨ 主な機能

• 実行時設定：サーバーを再起動することなくパラメータを更新できます。
• モジュール化設計：複数の異なるMCPサーバータイプをサポートします。
• 安全な伝送：パラメータは暗号化チャネルを介して伝送され、機密情報の安全性を確保します。
• 使いやすさ：シンプルなコマンドラインインターフェースとドキュメントが提供され、ユーザーが簡単に使い始めることができます。

📦 インストール

npxを使用してスーパーパラメータを実行します。

npx -y superargs --stdio "npx -y @modelcontextprotocol/server-postgres {{databaseUrl}}"

• --stdio：stdio MCPサーバーを実行するシェルコマンドを指定し、{{argName}}の形式で指定された位置に実行時パラメータを置き換えます。
• --update-args-tool-name：（オプション）パラメータの更新/再起動に使用するツール名をカスタマイズします。デフォルトはupdate_argsです。

パラメータ

--stdioコマンド内のパラメータは{{argName}}で表されます。例えば：

npx -y superargs --stdio "GITHUB_PERSONAL_ACCESS_TOKEN={{githubToken}} npx -y @modelcontextprotocol/server-github"

このコマンドでは、{{githubToken}}は実行時にupdate_argsツール（または指定された場合はカスタムツール名）を使用して設定されるパラメータです。

💻 使用例

基本的な使用法

npx -y superargs --stdio "GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token_here"

このコマンドでは、{{githubToken}}を実際のGitHubトークンに置き換えます。これにより、実行時にGitHubトークンを提供し、認証が必要な操作を実行できます。

高度な使用法

npx -y superargs --stdio "DB_USER=root DB_PASSWORD=password DB_HOST=localhost DB_PORT=5432"

このコマンドでは、PostgreSQLデータベースへのアクセスを設定します。実行時にデータベースの資格情報を提供し、指定されたPostgreSQLインスタンスに接続できます。

実行後の状態

• 初期状態：起動時、MCPサーバーにはパラメータが設定されていません。
  • パラメータなしでstdio MCPサーバーを起動できる場合、サーバーはパラメータなしで起動し、ツールリストやその他のMCPサーバー機能を提供します。パラメータなしでも正常に動作する場合、唯一の違いはパラメータを更新するためのupdate_argsツールが追加されることです。
  • サーバーがパラメータを必要とする場合、パラメータが設定されるまでサーバーは起動せず、update_argsツール以外のすべてのMCPサーバー機能は使用できません。
• update_argsツール：パラメータが正常に渡された後、このツールを使用して対話することができます。

📚 ドキュメント

なぜMCPプロトコルを選ぶのか

MCP（Multi - Agent Collaboration Protocol）は、AIツール間のデータ交換に使用される標準プロトコルです。MCPサーバーが認証トークンや設定パスなどの動的パラメータを必要とする場合、スーパーパラメータを使用することで、サーバーコードを変更することなく実行時にこれらのパラメータを提供できます。これにより、デプロイ、リモートアクセス、デバッグがより柔軟になります。

🤝 貢献

貢献を歓迎します！新機能のアイデア、改善提案、または問題がある場合は、問題を開くか、プルリクエストを送信してください。

📄 ライセンス

MIT License