MCP Servers Collection

Colección de Servidores MCP

Una colección de servidores del Model Context Protocol (MCP) para mejorar las capacidades de las herramientas de IA. Estos servidores proporcionan interfaces estructuradas para que los asistentes de IA interactúen con diversas herramientas y servicios de desarrollo.

¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA conectarse de forma segura a fuentes de datos y herramientas externas. Los servidores MCP exponen funcionalidades específicas como herramientas que los asistentes de IA pueden descubrir y utilizar.

Servidores Disponibles

🔄 Servidor Overmind

Ruta: overmind/
Propósito: Gestión de procesos para aplicaciones basadas en Procfile utilizando Overmind

Instalación:

uvx --from git+https://github.com/geoffjay/mcp-servers#subdirectory=overmind mcp-server-overmind

📈 Servidor de Análisis Fundamental

Ruta: fundamental_analysis/ Propósito: Realiza análisis fundamental para un código de acción determinado utilizando la API de Finnhub.

Instalación:

uvx --from git+https://github.com/geoffjay/mcp-servers#subdirectory=fundamental_analysis mcp-server-fundamental-analysis

Características Principales:

• Iniciar, detener y reiniciar procesos definidos en Procfiles
• Monitorear el estado y la salud de los procesos
• Ejecutar comandos dentro del entorno de Overmind
• Detección basada en sockets de instancias en ejecución
• Soporte para ubicaciones y formaciones personalizadas de Procfile

Herramientas Disponibles:

• overmind_start - Iniciar Overmind con configuración opcional
• overmind_stop - Detener procesos específicos o todos los procesos
• overmind_restart - Reiniciar procesos especificados
• overmind_status - Obtener el estado de todos los procesos
• overmind_quit - Salir de Overmind de forma ordenada
• overmind_kill - Terminar todos los procesos de forma forzada
• overmind_run - Ejecutar comandos en el entorno de Overmind
• overmind_connect - Obtener instrucciones de conexión para procesos
• overmind_is_running - Verificar si Overmind está en ejecución
• overmind_check_procfile - Validar la existencia y el contenido del Procfile
• overmind_find_procfiles - Encontrar todos los Procfiles en un árbol de directorios

Requisitos: Overmind y tmux deben estar instalados en el sistema.

Pruebas: El directorio overmind/test_environment/ contiene una configuración de prueba completa con procesos de muestra y utilidades de prueba. Ejecute ./overmind/test_environment/run_tests.sh para realizar pruebas exhaustivas.

Inicio Rápido

Uso con Claude Desktop

Agregue cualquiera de estos servidores a su configuración de Claude Desktop:

{
  "mcpServers": {
    "overmind": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/geoffjay/mcp-servers#subdirectory=overmind",
        "mcp-server-overmind"
      ]
    }
  }
}

Uso con Otros Clientes MCP

Cada servidor se puede ejecutar directamente:

# Overmind server
uvx --from git+https://github.com/geoffjay/mcp-servers#subdirectory=overmind mcp-server-overmind

Desarrollo

Requisitos Previos

• Python 3.10 o superior
• uv para la gestión de dependencias
• direnv (opcional, para activación automática del entorno)

Estructura del Proyecto

mcp-servers/
├── README.md                 # This file
├── overmind/                 # Overmind process manager server
│   ├── src/mcp_server_overmind/
│   ├── tests/
│   ├── pyproject.toml
│   ├── .envrc
│   └── README.md
└── [future-servers]/         # Additional servers will be added here

Agregar un Nuevo Servidor

1. Cree un nuevo directorio para su servidor
2. Configure la estructura del proyecto:

   your-server/
   ├── src/mcp_server_yourname/
   │   ├── __init__.py
   │   └── server.py
   ├── tests/
   ├── pyproject.toml
   ├── .envrc
   └── README.md
   

3. Configure pyproject.toml con:
   • Nombre del paquete: mcp-server-yourname
   • Punto de entrada: mcp-server-yourname = "mcp_server_yourname.server:main"
   • Dependencias incluyendo mcp>=1.2.0
4. Implemente su servidor utilizando el framework FastMCP
5. Agregue pruebas exhaustivas
6. Documente su servidor en su README.md
7. Actualice este README.md principal para incluir su servidor

Ejecutar Pruebas

Cada servidor incluye su propio conjunto de pruebas:

cd your-server-directory
uv run --extra dev pytest tests/ -v

Compilar y Probar Localmente

cd your-server-directory
uv build
uv run your-entry-point

Contribuciones

¡Agradecemos las contribuciones! Por favor:

1. Siga la estructura y los patrones existentes del proyecto
2. Incluya pruebas exhaustivas para nuevas funcionalidades
3. Agregue documentación completa
4. Asegúrese de que su servidor siga las mejores prácticas de MCP
5. Actualice este README al agregar nuevos servidores

Estilo de Código

• Utilice anotaciones de tipo de Python en todo el código
• Siga los patrones async/await para operaciones de E/S
• Incluya docstrings para todas las funciones públicas
• Utilice nombres descriptivos para las herramientas y documentación clara de parámetros

Requisitos de Pruebas

• Logre una alta cobertura de pruebas (apunte a >90%)
• Incluya pruebas unitarias y de integración
• Simule adecuadamente las dependencias externas
• Pruebe tanto escenarios de éxito como de fallo

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte los directorios individuales de los servidores para obtener información específica sobre licencias.

Recursos

• Documentación del Model Context Protocol
• SDK de Python para MCP
• Framework FastMCP
• Guía de MCP para Claude Desktop

Soporte

Para problemas con servidores específicos, consulte sus archivos README individuales. Para problemas o preguntas generales del proyecto, abra un issue en este repositorio.

---

Estado de los Servidores

Servidor	Estado	Versión	Última Actualización
overmind	✅ Estable	0.1.0	Enero 2025
fundamental_analysis	✅ Estable	0.1.0	Enero 2025

Hoja de Ruta

Futuros servidores en consideración:

• Configuración del entorno de desarrollo
• Procesamiento de audio (MIDI/OSC)