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

貢獻

歡迎貢獻！無論您有關於新功能的想法、改進建議，還是遇到任何問題，請打開 問題 或提交 拉取請求。