Installation & Usage
2025.03.16
35
JavaScriptMCP 服务器参数动态更新运行时参数配置开发效率
Superargs 是一个 MCP 服务器参数动态更新工具，允许在运行时为 MCP 服务器提供参数，而不是在初始设置时。它支持动态注入认证令牌、环境变量或其他 CLI 参数，使得在运行时提供这些参数变得简单。Superargs 作为一个中间件包装器，围绕 MCP 服务器工作，支持所有 MCP 请求的转发，并引入了一个额外的工具来管理这些参数。
View on GitHub
Overview
基本能力
产品定位
Superargs 是一个 MCP 服务器参数动态更新工具，旨在简化 MCP 服务器的运行时参数配置。
核心功能
- 动态参数注入：在运行时替换 MCP 服务器命令中的占位符。
- 自定义工具名称：通过
--update-args-tool-name重命名参数更新工具。 - 全面的 MCP 支持：转发所有 MCP 请求到子服务器，包括工具、提示、资源、消息和根。
- 变更通知：在参数更新时发送通知，确保连接的客户端知晓变更。
适用场景
- 动态配置 MCP 服务器参数，如认证令牌或环境变量。
- 在 AI 助手交互过程中动态设置服务器参数。
- 远程访问和调试 MCP 服务器。
工具列表
- update_args：默认工具，用于更新参数并重启子 MCP 服务器。
常见问题解答
- 如何安全传递敏感参数：参数通过命令传递给子 MCP 服务器，不会被存储。如果不希望 LLM 看到这些参数，可以直接通过服务器客户端调用 MCP 服务器。
使用教程
使用依赖
无特殊前置依赖，只需安装 Node.js 和 npm。
安装教程
通过 npx 运行 Superargs：
npx -y superargs --stdio "npx -y @modelcontextprotocol/server-postgres {{databaseUrl}}"
调试方式
- 使用 MCP Inspector 连接 Superargs：
npx @modelcontextprotocol/inspector npx -y superargs --stdio "npx -y @modelcontextprotocol/server-postgres {{databaseUrl}}"
- 通过 MCP Inspector 管理 MCP 服务器，如列出工具、运行提示等。