Skip to main content
Glama
deenesjakoruzh

MCP Toolbox

by ai-zerolab
GitHub
Python
Apache 2.0
23
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

caja de herramientas mcp

Liberar Estado de compilación código decodificador Actividad de confirmación Licencia

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.

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

  1. Configure Claude Desktop como se muestra en la sección Configuración

  2. Iniciar Claude Desktop

  3. 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

  4. 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."

  5. Pídele a Claude que descargue podcasts de XiaoyuZhouFM:

  6. 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

  7. 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 "

  8. Pídele a Claude que trabaje con contenido web:

  9. 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.

  10. 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:

  1. Actualice config.py con cualquier clave API requerida

  2. Crear un nuevo módulo en mcp_toolbox/

  3. Implemente su cliente API y herramientas

  4. Añade pruebas para tu nueva funcionalidad

  5. 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.

  1. Bifurcar el repositorio

  2. Crear una rama de características ( git checkout -b feature/amazing-feature )

  3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

  4. Empujar a la rama ( git push origin feature/amazing-feature )

  5. 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

How are these scores calculated?

hybrid server

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

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.

  1. Características
    1. Instalación
      1. Uso de uv (recomendado)
      2. Instalación mediante herrería
      3. Usando pip
    2. Configuración
      1. Variables de entorno
      2. Almacenamiento de memoria
      3. Configuración completa
    3. Herramientas disponibles
      1. Herramientas de línea de comandos
      2. Herramientas de operaciones de archivos
      3. Herramientas de Figma
      4. Herramientas de XiaoyuZhouFM
      5. Herramientas de audio
      6. Herramientas de memoria
      7. Herramientas de rebajas
      8. Herramientas web
      9. Herramientas de generación de imágenes de flujo
    4. Ejemplos de uso
      1. Ejecución del servidor MCP
      2. Uso con Claude Desktop
    5. Desarrollo
      1. Configuración local
      2. Ejecución de pruebas
      3. Ejecución de comprobaciones
      4. Documentación de construcción
    6. Agregar nuevas herramientas
      1. Contribuyendo
        1. Licencia

          Related Resources

          Related MCP Servers

          • Figma MCP Server

            TimHolden
            A
            security
            F
            license
            A
            quality
            Enables seamless interaction with Figma via the Model Context Protocol, allowing LLM applications to access, manipulate, and track Figma files, components, and variables.
            Last updated -
            107
            139
            • Apple

          • MCP Python Interpreter

            PortPro-Technologies-Inc
            A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that allows LLMs to interact with Python environments, enabling code execution, file operations, package management, and development workflows.
            Last updated -
            9

          • MCP TypeScript SDK

            Jeffwalters9597
            -
            security
            A
            license
            -
            quality
            A toolkit for building Model Context Protocol servers and clients that provide standardized context for LLMs, allowing applications to expose resources, tools, and prompts through stdio or Streamable HTTP transports.
            Last updated -
            7,267,844
            MIT License

          • MCP CLI

            james-gibson
            -
            security
            A
            license
            -
            quality
            A command-line tool for creating and running Model Context Protocol servers that expose resources, tools, and prompts to LLM clients.
            Last updated -
            183
            1
            AGPL 3.0

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/ai-zerolab/mcp-toolbox'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server