Kit de herramientas MCP

Una implementación de servidor modular para crear agentes de IA verticales de alta precisión. Diseñado para crear agentes de IA verticales de alta precisión, pero con implementación para acceder a la funcionalidad general de la herramienta.

Utiliza >=50% menos código que el SDK de Python MCP solo.

Beneficios de este enfoque

Reduce la carga cognitiva de Claude : Claude no necesita razonar sobre la secuencia de llamadas a herramientas.
Encapsula el conocimiento del dominio : el agente puede contener lógica específica del dominio sobre cómo realizar bien las tareas en un sector vertical en particular.
Simplifica el manejo de errores : el agente puede manejar errores y reintentos internamente sin la participación de Claude
Permite flujos de trabajo complejos : procesos de varios pasos que serían difíciles de coordinar mediante llamadas a herramientas individuales
Mantiene el flujo conversacional : el usuario no está expuesto a la complejidad del sistema subyacente.

Ejemplo de escenario

He aquí un ejemplo concreto de Claude invocando un agente vertical:

User: "I need a comprehensive analysis of the electric vehicle market for a presentation tomorrow."

Claude: [recognizes this requires multiple tools and domain expertise]

Claude: "I'll help you with that comprehensive EV market analysis. I'll need to gather the latest market data, news, and trends. This will take a moment..."

[Behind the scenes, Claude calls a MarketAnalysisAgent]

Claude -> MarketAnalysisAgent.analyze_market(
    sector="electric vehicles",
    include_news=True,
    include_market_data=True,
    create_presentation=True
)

[The agent orchestrates multiple tool calls using your toolkit]
- news_search for recent EV news
- brave_web_search for market data
- sequential_thinking for analysis
- write_file to save the report
- ppt_create_presentation to generate slides

[Agent returns results to Claude]

Claude: "I've analyzed the electric vehicle market for you. Here are the key findings:
1. Tesla continues to lead with 65% market share in North America
2. BYD has overtaken VW in global sales volume
3. Battery technology breakthroughs are accelerating adoption

I've also created a presentation with detailed charts and data. You can find it saved as 'EV_Market_Analysis.pptx' in your working directory."

Descripción general

El servidor unificado MCP proporciona una interfaz unificada para que Claude interactúe con varios sistemas y herramientas externos, incluidos:

Operaciones del sistema de archivos : leer, escribir y manipular archivos
Herramientas de tiempo : obtener la hora actual en diferentes zonas horarias, convertir entre zonas horarias
Pensamiento secuencial : una herramienta para la resolución dinámica y reflexiva de problemas
Brave Search : capacidades de búsqueda web y local
Automatización del navegador : control completo del navegador mediante Playwright
API del Banco Mundial : Acceso a datos económicos y de desarrollo
API de noticias : acceso a fuentes de noticias y artículos globales
PowerPoint : Crea y manipula presentaciones de PowerPoint
Excel : crear y manipular hojas de cálculo de Excel
Yahoo Finanzas : datos financieros y bursátiles
FRED : Datos económicos de la Reserva Federal
Capacidades de agente : cree e implemente agentes autónomos que realicen tareas complejas
Y muchas más herramientas especializadas

123 herramientas en total disponibles

Guía de inicio rápido: Implemente su primer servidor MCP con herramientas predeterminadas

Nota: Asegúrese de tener Git descargado ( https://git-scm.com/downloads ) y Docker descargado ( https://www.docker.com/products/docker-desktop/ ) y ejecutándose. También debe asegurarse de que el archivo ejecutable de Git esté agregado a la ruta (consulte las instrucciones al final de este archivo README).

Implementación de Docker (recomendada y más estable)

Clonar el repositorio:

clone https://github.com/getfounded/mcp-tool-kit.git
cd mcp-tool-kit

Luego puede usar Docker de una de dos maneras: Opción 1: usar docker-compose:

docker-compose up

Opción 2 - Comando directo de Docker:

docker run -p 8000:8000 -v ~/documents:/app/documents getfounded/mcp-tool-kit:latest

El repositorio incluye un archivo de configuración de escritorio de Claude de muestra ( claude_desktop_config.json ) que puedes usar:

{
  "mcpServers": {
    "unified": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "mcp-tool-kit-mcp-server",
        "python",
        "-u",
        "mcp_unified_server.py"
      ],
      "useStdio": true
    }
  }
}

Solución de problemas de Docker

Si recibe errores al ejecutar Docker, es probable que el nombre de la imagen sea incorrecto en el archivo de configuración del escritorio de Claude. Una solución habitual es usar el siguiente JSON para la configuración:

{
  "mcpServers": {
    "unified": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "mcp-tool-kit-mcp-server-1",
        "python",
        "-u",
        "mcp_unified_server.py"
      ],
      "useStdio": true
    }
  }
}

Instalar mediante pip

# Simple installation
pip install mcptoolkit

# Launch the server with default configuration
mcptoolkit-server

Configuración básica del servidor local:

{
  "tools": [
    {
      "name": "MCP Toolkit",
      "url": "http://localhost:8000"
    }
  ],
  "settings": {
    "allowed_directories": ["~/Documents", "~/Downloads"],
    "default_tools": ["MCP Toolkit"]
  }
}

Configurar Claude Desktop para acceder a su servidor

Abra la aplicación Claude Desktop
Vaya a Archivo > Configuración > Desarrollador > Editar configuración
Agregue el archivo 'claude_desktop_configuration.json'
Guardar la configuración
Reinicie el servidor MCP con su nueva herramienta integrada
Reinicie y abra la aplicación de escritorio Claude (los usuarios de Windows deben usar el administrador de tareas para finalizar la tarea en todas las instancias de Claude)

Puedes importar esta configuración en la aplicación de escritorio de Claude o usarla como referencia para crear la tuya propia.

Ahora tiene acceso inmediato a potentes capacidades que incluyen operaciones de archivos, búsqueda web, herramientas de tiempo y más, sin necesidad de claves API ni configuraciones complejas.

Configuración de variables de entorno

Después de clonar el repositorio, tiene dos opciones para configurar sus variables de entorno:

Opción 1: Guión de configuración interactivo

Ejecute el script de instalación que lo guiará en la configuración de sus variables de entorno:

python setup_env.py

Este script creará un archivo .env en el repositorio con su configuración.

Opción 2: Configuración manual

Alternativamente, puede crear manualmente un archivo .env en la raíz del repositorio con las siguientes variables:

# API Keys for external services
BRAVE_API_KEY=your_brave_api_key
NEWS_API_KEY=your_news_api_key
FRED_API_KEY=your_fred_api_key

# Application configuration
STREAMLIT_APPS_DIR=/path/to/streamlit/apps
MCP_FILESYSTEM_DIRS=/path/to/allowed/dir1,/path/to/allowed/dir2
MCP_LOG_LEVEL=info

Ejemplos de indicaciones de Claude

Una vez configurado, puedes pedirle a Claude que use las herramientas con indicaciones como:

Busque en la web los últimos artículos de investigación sobre IA y resuma los hallazgos.
"Crea una presentación de PowerPoint sobre el cambio climático con tres diapositivas".
"Utilice el agente weather_checker para indicarme las condiciones actuales en Tokio".
"¿Puedes utilizar el agente de búsqueda rápida para investigar los avances en computación cuántica?"
Descargue los datos de mis facturas de QuickBooks y analice nuestros ingresos del último trimestre.
"Configure un producto en mi tienda Shopify con estos detalles y precios".
"Obtenga el precio actual de las acciones y los datos históricos de Tesla utilizando Yahoo Finance".
"Analice las tendencias de inflación utilizando datos económicos de FRED de los últimos 5 años".
"Utilice la automatización del navegador para completar este formulario en [URL del sitio web]".
"Lea el archivo de texto en mi carpeta de Descargas llamado 'project_notes.txt'."
"Obtenga los últimos titulares de noticias sobre tecnología".

Herramientas disponibles

Herramientas del sistema de archivos

read_file : Leer el contenido de un archivo
read_multiple_files : Leer varios archivos simultáneamente
write_file : Crea o sobrescribe un archivo
edit_file : Realiza ediciones basadas en líneas en un archivo
create_directory : Crea un nuevo directorio
list_directory : Obtener el contenido del directorio
directory_tree : Obtener una vista de árbol recursiva
move_file : Mover o renombrar archivos/directorios
search_files : busca archivos que coincidan con un patrón
get_file_info : Obtener metadatos del archivo
list_allowed_directories : Lista de directorios permitidos
Automatización del navegador:
- playwright_launch_browser : Inicia una nueva instancia del navegador
- playwright_navigate : Navegar a una URL
- playwright_screenshot : Tomar una captura de pantalla
- playwright_click : Haz clic en un elemento
- playwright_fill : Rellene un campo de entrada
- playwright_evaluate : Ejecutar JavaScript
- playwright_get_content : Obtener el contenido HTML de una página

Herramientas del agente

run_agent : Ejecuta un agente registrado con parámetros
list_agents : enumera todos los agentes disponibles y sus metadatos

Herramientas de datos financieros

Yahoo Finanzas:
- yfinance : Obtenga cotizaciones de acciones y datos históricos
- yfinance_get_quote : Obtener la cotización actual de las acciones
- yfinance_get_history : Obtener datos históricos de acciones
- yfinance_get_info : Obtenga información detallada de la empresa
- yfinance_get_options : Obtener datos de la cadena de opciones
- yfinance_get_recommendations : Obtenga recomendaciones de analistas
FRED (Datos económicos de la Reserva Federal):
- fred_get_series : Obtener series de datos económicos
- fred_get_series_info : Obtener metadatos sobre una serie
- fred_search : Búsqueda de series de datos económicos
- fred_get_category : Explorar datos por categoría
- fred_get_releases : Obtener publicaciones de datos económicos
- fred_get_sources : Obtener fuentes de datos

Herramientas de tiempo

get_current_time : Obtener la hora actual en una zona horaria específica
convert_time : Convertir la hora entre zonas horarias

Pensamiento secuencial

sequentialthinking : una herramienta para descomponer problemas complejos mediante un proceso de pensamiento paso a paso

Búsqueda valiente

brave_web_search : Realizar búsquedas web
brave_local_search : Busca negocios y lugares locales

API del Banco Mundial

worldbank_get_indicator : Obtener datos de indicadores para un país

API de noticias

news_top_headlines : Obtenga los principales titulares de las noticias
news_search : Buscar artículos de noticias
news_sources : Lista de fuentes de noticias disponibles

Herramientas de PowerPoint

ppt_create_presentation : Crea una nueva presentación de PowerPoint
ppt_open_presentation : Abrir una presentación existente
ppt_save_presentation : Guardar una presentación
ppt_add_slide : Agregar una nueva diapositiva
ppt_add_text : Agregar texto a una diapositiva
ppt_add_image : Agregar una imagen a una diapositiva
ppt_add_chart : Agregar un gráfico a una diapositiva
ppt_add_table : Agregar una tabla a una diapositiva
ppt_analyze_presentation : Analizar la estructura de la presentación
ppt_enhance_presentation : Sugerir mejoras
ppt_generate_presentation : Generar una presentación a partir de texto
ppt_command : Procesar comandos en lenguaje natural

Para obtener una lista completa de las herramientas disponibles, consulte la documentación o explore el directorio de herramientas.

Agregar un nuevo módulo de herramientas

Crea un nuevo archivo en el directorio tools (por ejemplo, my_tool.py )
Siga el patrón del módulo existente:
- Crear clase de servicio
- Definir funciones de herramientas
- Implementar funciones de registro
Actualice mcp_unified_server.py para importar y registrar su nuevo módulo

Ampliación de un módulo de herramientas existente

Agregar nuevos métodos a la clase de servicio
Agregar nuevas funciones de herramientas
Actualice la función de registro para incluir sus nuevas herramientas

Desarrollo con Docker

Puede utilizar Docker para el desarrollo para garantizar un entorno consistente:

# Build a development image
docker build -t mcp-tool-kit:dev .

# Run with source code mounted for development
docker run -p 8000:8000 \
    -v $(pwd):/app \
    -v ~/documents:/app/documents \
    mcp-tool-kit:dev

Esto monta su repositorio local en el contenedor, por lo que los cambios en el código se reflejan inmediatamente (para la mayoría de los archivos).

Perspectiva filosófica: La colaboración cognitiva entre humanos e IA

El Kit de Herramientas MCP representa un cambio de paradigma en la forma en que conceptualizamos la relación entre la inteligencia humana y los sistemas de IA. En lugar de considerar la IA como una mera herramienta para la automatización de tareas, este marco establece una alianza cognitiva donde el pensamiento estratégico humano y las capacidades operativas de la IA se complementan profundamente.

La arquitectura agencial encarna una visión transformadora: sistemas de IA capaces de interpretar el contexto de forma independiente, tomar decisiones dentro de parámetros definidos y ejecutar secuencias complejas de acciones, todo ello manteniendo la supervisión humana y la dirección estratégica. Esto representa no solo un avance tecnológico, sino un modelo fundamentalmente nuevo para la colaboración entre humanos y máquinas.

En este panorama cognitivo en evolución, las implementaciones más exitosas serán aquellas que equilibren cuidadosamente el potencial tecnológico con las capacidades humanas, creando interfaces que mejoren en lugar de reemplazar la toma de decisiones y la creatividad humanas.

Solución de problemas

El módulo no se carga : Verifique la ruta de importación y las dependencias
Errores de clave API : Verifique sus claves API en el archivo .env
Errores de permisos : Verifique los directorios permitidos en MCP_FILESYSTEM_DIRS
Errores de conexión : asegúrese de que el servidor esté en ejecución y el puerto sea accesible
Agente no detectado : Verifique que el archivo del agente esté en el directorio correcto y siga el formato requerido
Problemas con la ruta : asegúrese de que git se agregue a la ruta según las siguientes instrucciones

#Para agregar Git a PATH en Windows, siga estos pasos:

Localizar la instalación de Git: Determine la ruta donde está instalado Git en su sistema. Las rutas comunes incluyen C:\Archivos de programa\Git\bin\git.exe y C:\Archivos de programa\Git\cmd para una instalación estándar de Git, o C:\Users\AppData\Local\GitHub\PortableGit_\bin y C:\Users\AppData\Local\GitHub\PortableGit_\cmd si instaló Git a través de GitHub para Windows o GitHub Desktop.
Editar variables de entorno: Abra la aplicación "Editar variables de entorno" desde el Panel de control o buscando "Editar las variables de entorno del sistema" en el menú Inicio. En la sección "Variables del sistema", busque la variable "Ruta", haga clic en "Editar..." y añada la ruta a los archivos ejecutables y de comandos de Git. Asegúrese de que no haya espacios entre los puntos y comas que separan las rutas.
Guardar cambios: Después de agregar las rutas de Git, haga clic en "Aceptar" para guardar los cambios. Cierre y vuelva a abrir cualquier ventana del símbolo del sistema para aplicar la nueva configuración de PATH.
Verificar la instalación: abra un símbolo del sistema y ejecute git --version para verificar que Git sea accesible desde la línea de comando.

Licencia

El servidor unificado MCP tiene licencia MIT.

Expresiones de gratitud

Este proyecto utiliza varias bibliotecas y API de código abierto:

SDK de MCP para asistentes de IA de Claude
NewsAPI para acceder a noticias
API de Brave Search para búsqueda web
API del Banco Mundial para datos económicos
python-pptx para la manipulación de PowerPoint
XlsxWriter para hojas de cálculo de Excel

MCP Unified Server

Integrations