微信扫一扫README
🚀 超级参数：通过聊天更新MCP服务器参数
超级参数（Superargs） 允许在运行时设置MCP服务器参数。无需在初始设置时进行配置，您可以在与助理交互期间为任何 MCP服务器 提供参数。无论是身份验证令牌、环境变量，还是其他CLI参数，超级参数都能让您在运行时轻松提供。
超级参数得到了 superinterface.ai、supermachine.ai 和 supercorp.ai 的支持。
🚀 快速开始
安装与使用
通过 npx 运行超级参数：
npx -y superargs --stdio "npx -y @modelcontextprotocol/server-postgres {{databaseUrl}}"
--stdio：运行一个stdio MCP服务器的shell命令，并在形式为{{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工具（或自定义工具名称，如果指定了）设置的参数。
✨ 主要特性
- 运行时配置：允许在不重新启动服务器的情况下更新参数。
- 模块化设计：支持多种不同的MCP服务器类型。
- 安全传输：参数通过加密通道传递，确保敏感信息的安全性。
- 易于使用：提供简洁的命令行界面和文档，使用户能够轻松上手。
📦 安装指南
通过 npx 运行超级参数：
npx -y superargs --stdio "npx -y @modelcontextprotocol/server-postgres {{databaseUrl}}"
参数说明：
| 参数 | 详情 |
|------|------|
| --stdio | 运行一个stdio MCP服务器的shell命令，并在形式为 {{argName}} 的位置替换运行时参数 |
| --update-args-tool-name | （可选）自定义更新/重启参数的工具名称，默认为 update_args |
💻 使用示例
基础用法
将 {{githubToken}} 替换为实际的GitHub令牌：
npx -y superargs --stdio "GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token_here"
这将允许您在运行时提供GitHub令牌，以便MCP服务器可以使用它执行需要身份验证的操作。
高级用法
配置PostgreSQL数据库访问：
npx -y superargs --stdio "DB_USER=root DB_PASSWORD=password DB_HOST=localhost DB_PORT=5432"
这将允许您在运行时提供数据库凭据，以便MCP服务器可以连接到指定的PostgreSQL实例。
📚 详细文档
运行后
- 初始状态：在启动时，MCP服务器没有任何参数。
- 如果底层stdio MCP服务器可以在没有参数的情况下启动，它将尝试不带参数地启动，以提供工具列表和其他MCP服务器功能。如果没有参数也可以正常工作，则唯一的区别是会多出一个
update_args工具来更新参数。 如果服务器需要参数才能启动，则在参数设置之前服务器不会启动，并且除了update_args工具外，所有其他MCP服务器功能都无法使用。 update_args工具：当参数被成功传递后，您可以使用此工具进行交互。
工作原理
超级参数通过在运行时注入所需的参数来工作。这些参数可以是任何类型，包括字符串、数字或布尔值，并且可以通过命令行传递或从环境变量读取。
超级参数的核心功能是将参数解析为适合MCP服务器使用的格式，并将其传递到相应的工具中。这使得配置动态和灵活的AI服务成为可能。
为什么选择MCP协议
MCP（Multi - Agent Collaboration Protocol）是一种用于AI工具之间数据交换的标准协议。如果您的MCP服务器需要动态参数，例如身份验证令牌或配置路径，超级参数允许您在运行时提供这些参数而不必修改服务器代码。这使得部署、远程访问和调试变得更加灵活。