supercorp-ai/superargs

Superargs は実行時に MCP サーバーの args を設定できます。 初期設定の代わりにアシスタントとのやり取り中に、MCP サーバ に引数を指定できます。 認証トークン、環境変数、またはその他のCLI引数であっても、Superargsはランタイム中に簡単に提供できます。

superinterface.ai、supermachine.aiおよびsupercorp.aiによって支えられて。

インストールと使用

[npxを介してスーパーアグを実行します。

-[--stdio: フォーム[{{argName}}で実行時にargsでstdio MCPサーバーを実行するShellコマンド。

• [[--update-args-tool-name:(任意) 更新/再起動のargsに使用するツールのカスタム名。 update_args にデフォルトを指定します。

################################################################################################################################################################################################################################################################

[--stdio] コマンドの引数は [{{argName}}] で区切られます。 例えば:

このコマンドで:

• [[{{githubToken}}]は、[update_args]ツール(または指定された場合はカスタムツール名)を使用してランタイムで設定できるアーグです。

開始

• 初期状態: 起動時に、MCP サーバーには、任意の args が設定されていない。

• MCP の stdio サーバーが args なしで起動できる場合は、ツールリストやその他の MCP サーバー機能を提供せずに起動します.

Superargs allows setting up MCP server args during runtime. Provide arguments to any MCP server during interaction with assistant instead of during initial setup. Whether it’s authentication tokens, environment variables, or other CLI arguments, Superargs makes it easy to provide it during runtime.

Supported by superinterface.ai, supermachine.ai and supercorp.ai.

Installation & Usage

Run Superargs via npx:

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

• --stdio: Shell command that runs a stdio MCP server with args to be replaced during runtime in the form {{argName}}.
• --update-args-tool-name: (Optional) Custom name for the tool used to update/restart args. Defaults to update_args.

Args

Args in the --stdio command are denoted by {{argName}}. For example:

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

In this command:

• {{githubToken}} is an arg that can be set at runtime using the update_args tool (or a custom tool name if specified).

Once Started

• Initial state: At the start, the MCP server will not have any args set.

• If underlying MCP stdio server can start without args, it will try to start without them to provide tools lists and other MCP server functions. If it can work without args, the only difference will be that it will have an additional update_args tool to update args.

• If the server requires args to start, it will not start until the args are set and it will only have the update_args tool. All other MCP server functions will either return an empty list or an error message.

• When update_args is used: The server will restart with the new args and all MCP server functions will be available.

• Tool to Update Args: By default, named update_args, allows updating args and restarting the child MCP server.

Examples

Another example with GitHub MCP server:

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

And with SQLite MCP server:

npx -y superargs --stdio "uv mcp-server-sqlite --db-path={{dbPath}}"

Example with MCP Inspector

1. Run MCP Inspector with Superargs:

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

   This command starts Superargs and connects it to MCP Inspector, enabling you to manage your PostgreSQL MCP server through the inspector interface.

2. Manage MCP Server:

   With MCP Inspector, you can list tools, run prompts, access resources, or perform other MCP actions through Superargs.