Sample MCP Server Tos

🚀 TOS 模型上下文協議服務器示例 MCP 服務

本項目是一個用於從 TOS 提取數據的 MCP 服務器實現，能幫助用戶便捷地與 VolcEngine TOS 進行交互，實現數據的提取與管理。

🚀 快速開始

運行服務器

# 以默認的 stdio 傳輸運行服務器
tos-mcp-server

✨ 主要特性

工具

• list_buckets
  返回所有由發送請求的認證發送者擁有的桶列表。
• list_objects
  返回某個桶中的部分或全部（最多 1,000）對象。每個請求返回一定數量的對象。
• get_object
  從 VolcEngine TOS 中檢索一個對象。在 GetObject 請求中，指定要檢索的對象的完整鍵名。通用用途桶 - 支持虛擬主機樣式請求和路徑樣式請求。

📦 安裝指南

配置

該服務器需要以下環境變量設置：

• VOLC_ACCESSKEY：必需，VolcEngine 的訪問密鑰。
• VOLC_SECRETKEY：必需，VolcEngine 的秘密密鑰。
• REGION：必需，TOS 服務所在的區域。
• TOS_ENDPOINT：必需，TOS 服務的端點。
• SECURITY_TOKEN：可選，憑證的安全令牌。
• TOS_BUCKETS：可選，如果你希望使用特定的桶，則需要設置此變量。

你可以在 shell 中設置這些環境變量。

MCP 設置配置

要將此服務器添加到你的 MCP 配置中，請在你的 MCP 設置文件中添加以下內容：

{
  "mcpServers": {
    "tos-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/mcp_server_tos",
        "run",
        "main.py"
      ]
    }
  }
}

或

{
    "mcpServers": {
        "tls": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/volcengine/ai-app-lab#subdirectory=mcp/server/mcp_server_tos",
                "mcp-server-tos"
            ],
            "env": {
                "VOLC_ACCESSKEY": "your ak",
                "VOLC_SECRETKEY": "your sk",
                "REGION": "tos 區域",
                "TOS_ENDPOINT": "tos 端點",
                "SECURITY_TOKEN": "你的安全令牌",
                "TOS_BUCKET": "你要使用的特定桶"
            }
        }
    }
}

📄 許可證

此庫根據 MIT-0 許可證發佈。有關詳細信息，請參閱 LICENSE 文件。