Superargs

by supercorp-ai

72 179 downloads Not rated yet MIT
GitHub

About

Superargs is a middleware wrapper for MCP servers that allows setting up MCP server arguments during runtime instead of during initial setup. It acts as a proxy that forwards all MCP requests (tools, prompts, resources, messages, roots) to a child server and introduces an…

Details

License
MIT

Explore

- Dynamic Arg Injection: Replace placeholders in your MCP server command with actual values during runtime.
- Customizable Tool Name: Rename the arg update tool via --update-args-tool-name to suit your workflow.
- Comprehensive MCP Support: Forwards all MCP requests to the child server, including tools, prompts, resources, messages, and roots.
- Change Notifications: Sends notifications like sendToolListChanged, sendPromptListChanged, and sendResourceUpdated when args are updated, ensuring connected clients are aware of changes.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Superargs
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "superargs": {
            "superargs": {
                "command": "npx",
                "args": [
                    "-y",
                    "superargs",
                    "--stdio",
                    "npx -y @modelcontextprotocol/server-postgres {{databaseUrl}}"
                ]
            }
        }
    }
}

McpServers

{
    "superargs": {
        "command": "npx",
        "args": [
            "-y",
            "superargs",
            "--stdio",
            "npx -y @modelcontextprotocol/server-postgres {{databaseUrl}}"
        ]
    }
}

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).

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.