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 文件。