TOS MCP Server

Explora y recupera contenido del Almacenamiento de Objetos Tinder (TOS) de Volcengine mediante consultas en lenguaje natural.

Documentación

TOS MCP Server

El MCP Server oficial de TOS ofrece potentes capacidades de consulta, permitiendo explorar y recuperar contenido almacenado en TOS de manera conveniente mediante lenguaje natural, mejorando la intuición y eficiencia del acceso a datos. Se puede combinar con los MCP de productos en la nube de Volcano Engine para ayudar a construir escenarios de aplicaciones empresariales más inteligentes.

Versiónv0.2.0
DescripciónGestión de recursos TOS basada en MCP, exploración inteligente de datos
CategoríaAlmacenamiento
EtiquetasBúsqueda, video, imagen, texto

Tools

Este producto MCP Server ofrece las siguientes Tools (herramientas/capacidades):

Tool 1: list_buckets

Tipo

SaaS

Descripción detallada

Esta herramienta le permite ver convenientemente la lista de buckets de TOS de Volcano Engine.

Parámetros de entrada necesarios para depuración:

Entrada:

{
  "inputSchema": {
    "type": "object",
    "required": [],
    "properties": {}
  },
  "name": "list_buckets",
  "description": "查询您账号下拥有的所有存储桶的列表。"
}

Salida:

  • Devuelve la lista de buckets bajo su cuenta, incluyendo nombre del bucket, tiempo de creación, información de ubicación del bucket, dominio de acceso y otra información.

Ejemplo de Prompt más fácil de invocar

列举火山引擎 TOS 的存储桶列表。

Tool 2: list_objects

Tipo

SaaS

Descripción detallada

Esta herramienta le permite ver convenientemente la lista de objetos bajo un bucket de TOS de Volcano Engine. Cada solicitud devuelve parte o todos los objetos del bucket (máximo 1000). Puede usar parámetros de solicitud como condiciones de selección para devolver un subconjunto de objetos del bucket.

Parámetros de entrada necesarios para depuración:

Entrada:

{
  "inputSchema": {
    "type": "object",
    "required": [
      "bucket"
    ],
    "properties": {
      "bucket": {
        "type": "string",
        "description": "用户指定的存储桶名称"
      },
      "prefix": {
        "type": "string",
        "description": "可选的对象前缀"
      },
      "start_after": {
        "type": "string",
        "description": "列举对象的起始位置。您可以通过指定对象的起始位置分页列举对象"
      },
      "continuation_token": {
        "type": "string",
        "description": "指定列举操作从该 Token 开始,通常从上次请求返回的 NextContinuationToken 中获取此 Token"
      }
    }
  },
  "name": "list_objects",
  "description": "查询您指定存储桶的对象列表"
}

Salida:

  • Devuelve la lista de objetos bajo el almacenamiento especificado, incluyendo nombre del objeto, hora de última modificación, ETag, tamaño del objeto, tipo de almacenamiento y otra información.

Ejemplo de Prompt más fácil de invocar

列举火山引擎 TOS 的 example 桶下的对象。

Tool 3: get_object tool

Tipo

SaaS

Descripción detallada

Recupera objetos de TOS; debe especificar el nombre del bucket y la ruta completa del objeto. Para objetos con contenido de texto, como archivos de texto, archivos CSV, etc., esta herramienta devuelve su contenido. Para objetos binarios como imágenes y videos, esta herramienta devuelve el contenido codificado en Base64.

Parámetros de entrada necesarios para depuración:

Entrada:

{
  "inputSchema": {
    "type": "object",
    "required": [
      "bucket",
      "key"
    ],
    "properties": {
      "bucket": {
        "type": "string",
        "description": "用户指定的存储桶名称"
      },
      "key": {
        "type": "string",
        "description": "用户需要读取的对象名,需要指定完整的对象名"
      }
    }
  },
  "name": "get_object",
  "description": "获取指定对象的内容,对于文本内容的对象,比如文本文件、CSV 文件等,该工具返回的是其内容。对于图片、视频等二进制对象,该工具返回的是Base64编码的内容。"
}

Salida:

  • Devuelve el contenido específico del objeto. Para objetos con contenido de texto, como archivos de texto, archivos CSV, etc., esta herramienta devuelve el contenido. Para objetos binarios como imágenes y videos, esta herramienta devuelve el contenido codificado en Base64.

Ejemplo de Prompt más fácil de invocar

读取火山引擎 TOS 桶example下对象名为example.txt的文件内容

Plataformas adaptables

Ark, python, cursor

Enlace de activación del servicio (producto completo)

https://console.volcengine.com/tos

Método de autenticación

Volcano Engine: obtenga el ID de clave de acceso, la clave de acceso secreta y la región de volcengine desde la consola de administración de volcengine. Configure las variables de entorno correspondientes en el archivo .env

Variables de entorno

Las siguientes variables de entorno se pueden usar para configurar el servidor MCP:

Variable de entornoDescripciónValor predeterminado
VOLCENGINE_ACCESS_KEYClave de acceso de la cuenta de Volcano Engine-
VOLCENGINE_SECRET_KEYClave secreta de la cuenta de Volcano Engine-
VOLCENGINE_REGIONRegión de TOS de Volcano Engine-
TOS_ENDPOINTEndpoint de TOS de Volcano Engine-
SECURITY_TOKENToken de seguridad de Volcano Engine, opcional-
TOS_BUCKETSBucket de TOS especificado para acceder, opcional-

Instalación e implementación

Dependencias del sistema

  • Instalar Python 3.10 o superior
  • Instalar uv
    • Si es sistema Linux
    curl -LsSf https://astral.sh/uv/install.sh | sh
    
    • Si es sistema Windows
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    
  • Sincronizar dependencias y actualizar uv.lock:
    uv sync
    
  • Construir el servidor MCP:
    uv build
    

Usando uv (recomendado)

Cuando se usa uv no se necesita instalación específica. Usaremos uvx para ejecutar directamente mcp-server-tos.

Configuración local

Agregue la siguiente configuración a su archivo de configuración de mcp

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

Configuración en diferentes plataformas

Ark

Centro de experiencia

[Ejemplo a continuación]

  1. Ver detalles del MCP Server En la plaza del ecosistema de modelos grandes, seleccione el MCP Server adecuado y vea los detalles
  2. Seleccionar la plataforma donde se ejecutará el MCP Server Verifique las plataformas adaptadas del MCP Server actual y seleccione la plataforma adecuada
  3. Ver y comparar las Tools disponibles Revise cuidadosamente las descripciones de funciones y los parámetros de entrada requeridos de las Tools disponibles, e intente ejecutar las funciones correspondientes.
  4. Obtener URL exclusiva o ejemplos de código Verifique el estado de inicio de sesión de la cuenta y el estado de activación del servicio, y genere una URL única
  5. Ir a la plataforma del Cliente correspondiente para su uso Haga clic en el botón de acceso rápido para ir al centro de experiencia de la plataforma Ark y probar el MCP Server correspondiente

Capturas de pantalla/videos del producto - opcional

Cursor

Implementación

[Ejemplo a continuación]

UVX

{
  "mcpServers": {
    "tos-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_tos",
        "mcp-server-tos"
      ],
      "env": {
        "VOLCENGINE_ACCESS_KEY": "your access-key-id",
        "VOLCENGINE_SECRET_KEY": "your access-key-secret",
        "VOLCENGINE_REGION": "tos region",
        "TOS_ENDPOINT": "tos endpoint",
        "SECURITY_TOKEN": "your security token",
        "TOS_BUCKET": "your specific bucket"
      }
    }
  }
}

Licencia

volcengine/mcp-server está licenciado bajo la Licencia MIT.