MCP Tool Kit

MCP Tool Kit

Un kit de herramientas integral para el Protocolo de Contexto del Modelo (MCP) con descubrimiento automático de herramientas y múltiples opciones de transporte.

📚 Documentación oficial | 🌐 Sitio web | 💬 Comunidad

🚀 Creado por UsefulAI | 📖 De GitHub al éxito comercial

🚀 Instalación rápida: ¡no se requiere Git!

Elige tu plataforma y ejecuta UN comando:

🖥️ Windows (PowerShell)

irm https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.ps1 | iex

🍎 macOS (Terminal)

bash <(curl -s https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)

🐧 Linux (Terminal)

bash <(wget -qO- https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)

¡Eso es todo! El instalador:

• ✅ Descargará MCP Tool Kit (¡no se necesita Git!)
• ✅ Verificará Docker (ayuda a instalarlo si falta)
• ✅ Creará accesos directos en el escritorio
• ✅ Configurará todo automáticamente

📦 Métodos de instalación alternativos

docker run -it --name mcp-toolkit ghcr.io/getfounded/mcp-tool-kit:latest

🔧 Características

Registro dinámico de herramientas

Las herramientas se descubren y registran automáticamente en tiempo de ejecución: ¡no se necesita configuración manual!

Opciones de transporte múltiples

• stdio: Para integración con Claude Desktop
• SSE (Server-Sent Events): Para acceso basado en web

Más de 120 herramientas disponibles

• 📁 Sistema de archivos: Lee, escribe y gestiona archivos
• 🕐 Herramientas de tiempo: Conversiones de zona horaria y operaciones de tiempo
• 🌐 Búsqueda web: Integración con Brave Search
• 🤖 Automatización de navegador: Control de navegador basado en Playwright
• 📊 Análisis de datos: Datos de Yahoo Finance, FRED, Banco Mundial
• 📄 Herramientas de documentos: Manipulación de PDF, Excel, PowerPoint
• 🎯 ¡Y muchos más!

Configuración fácil

Controla todo a través de un simple archivo config.yaml:

enabled_tools:
  filesystem: true
  time_tools: true
  brave_search: true
  # ... more tools

tool_config:
  filesystem:
    allowed_directories: ["~/Documents", "~/Downloads"]
  brave_search:
    max_results: 10

📋 Configuración del entorno

1. Copia .env.template a .env
2. Añade tus claves de API:

   BRAVE_SEARCH_API_KEY=your_key_here
   NEWS_API_KEY=your_key_here
   FRED_API_KEY=your_key_here
   # ... other keys
   

💾 Configuración de almacenamiento

MCP Tool Kit utiliza un directorio de almacenamiento dedicado para operaciones de archivos:

• Windows: C:\Users\{Username}\mcp-tool-kit-storage
• Mac/Linux: ~/mcp-tool-kit-storage

Configuración automática

El directorio de almacenamiento se crea automáticamente cuando ejecutas el contenedor Docker por primera vez. También puedes configurarlo manualmente:

Windows (PowerShell):

.\scripts\setup-storage.ps1

Mac/Linux:

./scripts/setup-storage.sh

Estructura de almacenamiento

mcp-tool-kit-storage/
├── documents/     # For document files
├── downloads/     # For downloaded files
└── workspace/     # For temporary work files

Todas las operaciones de archivos a través de la herramienta de sistema de archivos estarán restringidas a este directorio por seguridad.

🔌 Conexión a Claude Desktop

1. Inicia el servidor en modo stdio usando el lanzador
2. Añade a la configuración de Claude Desktop:

   {
     "mcpServers": {
       "mcp-tool-kit": {
         "command": "docker",
         "args": ["exec", "-i", "mcp-server", "python", "mcp_server_v2.py"]
       }
     }
   }
   

🌐 Uso del modo SSE

1. Inicia el servidor en modo SSE usando el lanzador
2. Accede al servidor en http://localhost:8080
3. Usa los endpoints SSE:
   • /sse - Flujo de eventos enviados por el servidor
   • /messages - Envía mensajes al servidor

🛠️ Creación de herramientas personalizadas

Las herramientas ahora usan un sistema de clases base estandarizado:

from app.tools.base_tool import BaseTool

class MyCustomTool(BaseTool):
    def get_name(self) -> str:
        return "My Custom Tool"
        
    def get_tools(self) -> Dict[str, Callable]:
        return {
            "my_function": self.my_function
        }
        
    async def my_function(self, param: str, ctx: Context = None) -> str:
        return f"Processed: {param}"

Consulta la documentación para desarrolladores para guías detalladas.

📚 Documentación

La documentación completa está disponible en https://docs.mcp-tool-kit.com.

Para ejecutar la documentación localmente:

1. cd docs
2. npm install
3. npm start

🐳 Comandos de Docker

Uso del lanzador (recomendado)

Los scripts del lanzador manejan todas las operaciones de Docker automáticamente.

Comandos manuales

# Start server
docker-compose up -d

# View logs
docker-compose logs -f

# Stop server
docker-compose down

# Rebuild after changes
docker-compose build --no-cache

🤝 Contribuciones

1. Haz un fork del repositorio
2. Crea tu rama de características
3. Añade tu herramienta a app/tools/
4. Envía una solicitud de extracción

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.

🆘 Soporte

• GitHub Issues
• Documentación
• Comunidad de Discord (próximamente)