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ón | v0.2.0 |
|---|---|
| Descripción | Gestión de recursos TOS basada en MCP, exploración inteligente de datos |
| Categoría | Almacenamiento |
| Etiquetas | Bú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 entorno | Descripción | Valor predeterminado |
|---|---|---|
VOLCENGINE_ACCESS_KEY | Clave de acceso de la cuenta de Volcano Engine | - |
VOLCENGINE_SECRET_KEY | Clave secreta de la cuenta de Volcano Engine | - |
VOLCENGINE_REGION | Región de TOS de Volcano Engine | - |
TOS_ENDPOINT | Endpoint de TOS de Volcano Engine | - |
SECURITY_TOKEN | Token de seguridad de Volcano Engine, opcional | - |
TOS_BUCKETS | Bucket 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]
- Ver detalles del MCP Server En la plaza del ecosistema de modelos grandes, seleccione el MCP Server adecuado y vea los detalles
- Seleccionar la plataforma donde se ejecutará el MCP Server Verifique las plataformas adaptadas del MCP Server actual y seleccione la plataforma adecuada
- 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.
- 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
- 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.