hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables web search functionality using the DuckDuckGo API
Allows access to Figma files, components, styles, and various Figma API operations including getting file information, nodes, images, comments, team projects, and more
Repository hosting for the project with workflows and actions integration

caja de herramientas mcp

Un conjunto completo de herramientas para mejorar las capacidades de LLM mediante el Protocolo de Contexto de Modelo (MCP). Este paquete proporciona un conjunto de herramientas que permiten a los LLM interactuar con servicios y API externas, ampliando su funcionalidad más allá de la generación de texto.

Repositorio de GitHub : https://github.com/ai-zerolab/mcp-toolbox/
(En proceso) Documentación : https://ai-zerolab.github.io/mcp-toolbox/

Características

*nix es nuestro objetivo principal, pero Windows también debería funcionar.

Ejecución de línea de comandos : ejecute cualquier instrucción de línea de comandos a través de LLM
Integración con Figma : acceda a archivos, componentes, estilos y más de Figma
Arquitectura extensible : agregue fácilmente nuevas integraciones de API
Compatibilidad con el protocolo MCP : compatible con Claude Desktop y otros LLM habilitados para MCP
Pruebas integrales : base de código bien probada con alta cobertura de pruebas

Instalación

Uso de uv (recomendado)

Recomendamos utilizar uv para gestionar su entorno.

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh  # For macOS/Linux
# or
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"  # For Windows

Luego, puede usar uvx "mcp-toolbox@latest" stdio como comando para ejecutar el servidor MCP con la última versión. Las herramientas de audio y memoria no están incluidas en la instalación predeterminada. Puede incluirlas instalando all los extras:

[audio] para herramientas de audio, [memoria] para herramientas de memoria, [todo] para todas las herramientas

uvx "mcp-toolbox[all]@latest" stdio

Instalación mediante herrería

Para instalar Toolbox for LLM Enhancement para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @ai-zerolab/mcp-toolbox --client claude

Usando pip

pip install "mcp-toolbox[all]"

También puedes usar mcp-toolbox stdio como comando para ejecutar el servidor MCP.

Configuración

Variables de entorno

Se pueden configurar las siguientes variables de entorno:

FIGMA_API_KEY : Clave API para la integración de Figma
TAVILY_API_KEY : Clave API para la integración de Tavily
DUCKDUCKGO_API_KEY : Clave API para la integración de DuckDuckGo
BFL_API_KEY : Clave API para la API de generación de imágenes Flux

Almacenamiento de memoria

Las herramientas de memoria almacenan datos en las siguientes ubicaciones:

macOS : ~/Documents/zerolab/mcp-toolbox/memory (se sincroniza entre dispositivos a través de iCloud)
Otras plataformas : ~/.zerolab/mcp-toolbox/memory

Configuración completa

Para utilizar mcp-toolbox con Claude Desktop/Cline/Cursor/..., agregue lo siguiente a su archivo de configuración:

{
  "mcpServers": {
    "zerolab-toolbox": {
      "command": "uvx",
      "args": ["--prerelease=allow", "mcp-toolbox@latest", "stdio"],
      "env": {
        "FIGMA_API_KEY": "your-figma-api-key",
        "TAVILY_API_KEY": "your-tavily-api-key",
        "DUCKDUCKGO_API_KEY": "your-duckduckgo-api-key",
        "BFL_API_KEY": "your-bfl-api-key"
      }
    }
  }
}

Para conocer todas las funciones:

{
  "mcpServers": {
    "zerolab-toolbox": {
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "--python=3.12",
        "mcp-toolbox[all]@latest",
        "stdio"
      ],
      "env": {
        "FIGMA_API_KEY": "your-figma-api-key",
        "TAVILY_API_KEY": "your-tavily-api-key",
        "DUCKDUCKGO_API_KEY": "your-duckduckgo-api-key",
        "BFL_API_KEY": "your-bfl-api-key"
      }
    }
  }
}

Puede generar una plantilla de configuración de depuración utilizando:

uv run generate_config_template.py

Herramientas disponibles

Herramientas de línea de comandos

Herramienta	Descripción
`execute_command`	Ejecutar una instrucción de línea de comandos

Herramientas de operaciones de archivos

Herramienta	Descripción
`read_file_content`	Leer el contenido de un archivo
`write_file_content`	Escribir contenido en un archivo
`replace_in_file`	Reemplazar contenido en un archivo usando expresiones regulares
`list_directory`	Listado de contenidos del directorio con información detallada

Herramientas de Figma

Herramienta	Descripción
`figma_get_file`	Obtener un archivo Figma por clave
`figma_get_file_nodes`	Obtener nodos específicos de un archivo Figma
`figma_get_image`	Obtener imágenes de los nodos en un archivo Figma
`figma_get_image_fills`	Obtener las URL de las imágenes utilizadas en un archivo Figma
`figma_get_comments`	Obtener comentarios en un archivo de Figma
`figma_post_comment`	Publicar un comentario en un archivo de Figma
`figma_delete_comment`	Eliminar un comentario de un archivo Figma
`figma_get_team_projects`	Conseguir proyectos para un equipo
`figma_get_project_files`	Obtener archivos para un proyecto
`figma_get_team_components`	Obtener componentes para un equipo
`figma_get_file_components`	Obtener componentes de un archivo
`figma_get_component`	Obtener un componente por clave
`figma_get_team_component_sets`	Obtener conjuntos de componentes para un equipo
`figma_get_team_styles`	Obtener estilos para un equipo
`figma_get_file_styles`	Obtener estilos de un archivo
`figma_get_style`	Obtener un estilo por clave

Herramientas de XiaoyuZhouFM

Herramienta	Descripción
`xiaoyuzhoufm_download`	Descargue un episodio de podcast de XiaoyuZhouFM con conversión automática opcional de m4a a mp3

Herramientas de audio

Herramienta	Descripción
`get_audio_length`	Obtenga la duración de un archivo de audio en segundos
`get_audio_text`	Obtener texto transcrito de un rango de tiempo específico en un archivo de audio

Herramientas de memoria

Herramienta	Descripción
`think`	Utilice la herramienta para pensar en algo y anexar el pensamiento al registro.
`get_session_id`	Obtener el ID de la sesión actual
`remember`	Almacenar un recuerdo (breve y detallado) en la base de datos de memoria
`recall`	Consultar memorias de la base de datos con búsqueda semántica
`forget`	Borrar todos los recuerdos en la base de datos de memoria

Herramientas de rebajas

Herramienta	Descripción
`convert_file_to_markdown`	Convierte cualquier archivo a Markdown usando MarkItDown
`convert_url_to_markdown`	Convertir una URL a Markdown usando MarkItDown

Herramientas web

Herramienta	Descripción
`get_html`	Obtener contenido HTML de una URL
`save_html`	Guardar HTML desde una URL a un archivo
`search_with_tavily`	Busque en la web usando Tavily (requiere clave API)
`search_with_duckduckgo`	Busque en la web usando DuckDuckGo (requiere clave API)

Herramientas de generación de imágenes de flujo

Herramienta	Descripción
`flux_generate_image`	Genere una imagen usando la API de Flux y guárdela en un archivo

Ejemplos de uso

Ejecución del servidor MCP

# Run with stdio transport (default)
mcp-toolbox stdio

# Run with SSE transport
mcp-toolbox sse --host localhost --port 9871

Uso con Claude Desktop

Configure Claude Desktop como se muestra en la sección Configuración
Iniciar Claude Desktop
Pídele a Claude que interactúe con los archivos de Figma:
- "¿Puedes obtener información sobre este archivo Figma: 12345abcde?"
- "Muéstrame los componentes en este archivo de Figma: 12345abcde"
- Obtener los comentarios de este archivo de Figma: 12345abcde
Pídale a Claude que ejecute las instrucciones de la línea de comandos:
- "¿Qué archivos hay en el directorio actual?"
- "¿Cuál es la hora actual del sistema?"
- "Muéstrame el contenido de un archivo específico."
Pídele a Claude que descargue podcasts de XiaoyuZhouFM:
- Descarga este episodio del podcast: https://www.xiaoyuzhoufm.com/episode/67c3d80fb0167b8db9e3ec0f
- Descarga y convierte este podcast a MP3: https://www.xiaoyuzhoufm.com/episode/67c3d80fb0167b8db9e3ec0f
Pídele a Claude que trabaje con archivos de audio:
- "¿Cuál es la duración de este archivo de audio: audio.m4a?"
- "Transcribe el audio de 60 a 90 segundos en audio.m4a"
- Obtener el texto de 2:30 a 3:00 en el archivo de audio
Pídele a Claude que convierta archivos o URL a Markdown:
- Convertir este archivo a Markdown: document.docx
- "Convertir esta página web a Markdown: https://example.com "
Pídele a Claude que trabaje con contenido web:
- "Obtener el contenido HTML de https://example.com "
- "Guardar el HTML de https://example.com en un archivo"
- Busca en la web noticias sobre inteligencia artificial.
Pídele a Claude que genere imágenes con Flux:
- Genera una imagen de un hermoso atardecer sobre las montañas.
- "Crea una imagen de una ciudad futurista y guárdala en mi escritorio"
- Generar un retrato de un gato con traje espacial.
Pídele a Claude que utilice herramientas de memoria:

Recuerden este dato importante: la capital de Francia es París.
"¿Cuál es mi ID de sesión actual?"
"¿Recordar alguna información sobre Francia?"
"Piensa en las implicaciones del cambio climático"
Olvida todos los recuerdos almacenados

Desarrollo

Configuración local

Bifurca el repositorio y clónalo en tu máquina local.

# Install in development mode
make install
# Activate a virtual environment
source .venv/bin/activate  # For macOS/Linux
# or
.venv\Scripts\activate  # For Windows

Ejecución de pruebas

make test

Ejecución de comprobaciones

make check

Documentación de construcción

make docs

Agregar nuevas herramientas

Para agregar una nueva integración de API:

Actualice config.py con cualquier clave API requerida
Crear un nuevo módulo en mcp_toolbox/
Implemente su cliente API y herramientas
Añade pruebas para tu nueva funcionalidad
Actualice el README.md con nuevas variables de entorno y herramientas

Consulte la guía de desarrollo para obtener instrucciones más detalladas.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Bifurcar el repositorio
Crear una rama de características ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo los términos de la licencia incluida en el repositorio.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un conjunto de herramientas integral que mejora las capacidades de LLM a través del Protocolo de contexto de modelo, lo que permite a los LLM interactuar con servicios externos, incluidas operaciones de línea de comandos, administración de archivos, integración de Figma y procesamiento de audio.

Related Resources

Reddit Discussion about this server

MCP Toolbox