Superargs

🚀 超级参数：通过聊天更新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}}"

参数说明：

💻 使用示例

基础用法

将 {{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服务器需要动态参数，例如身份验证令牌或配置路径，超级参数允许您在运行时提供这些参数而不必修改服务器代码。这使得部署、远程访问和调试变得更加灵活。

📄 许可证

MIT License

贡献

欢迎贡献！无论您有关于新功能的想法、改进建议，还是遇到任何问题，请打开 问题 或提交 拉取请求。