Berry MCP Server

Berry MCP Server

Un framework universal de servidor de Protocolo de Contexto de Modelo (MCP) que facilita la creación e implementación de servidores de herramientas personalizados para asistentes de IA como Claude.

✨ Características

• 🔧 Framework Universal: Crea servidores MCP para cualquier tipo de herramientas
• 🎯 Creación Simple de Herramientas: Registro de herramientas basado en decoradores con generación automática de esquemas JSON
• 🔌 Arquitectura de Plugins: Carga herramientas desde cualquier módulo o paquete de Python
• 🚀 Múltiples Transportes: Soporte para comunicación stdio y HTTP/SSE
• ⚙️ Configuración Flexible: Variables de entorno y opciones de línea de comandos
• 📝 Documentación Automática: Descubrimiento automático de herramientas y generación de esquemas
• 🔒 Seguridad de Tipos: Soporte completo de anotaciones de tipos con validación

🚀 Inicio Rápido

Instalación

# Install from PyPI (when published)
uv add berry-mcp

# Or install from source
git clone https://github.com/richinex/berry-mcp-server.git
cd berry-mcp-server
uv pip install -e .

Crea Tu Primera Herramienta

# my_tools.py
from berry_mcp.tools.decorators import tool

@tool(description="Add two numbers together")
def add_numbers(a: float, b: float) -> float:
    """Add two numbers and return the result"""
    return a + b

@tool(description="Generate a greeting message")  
def greet(name: str, title: str = "friend") -> str:
    """Generate a personalized greeting"""
    return f"Hello {title} {name}!"

Ejecuta Tu Servidor

# Load your custom tools
BERRY_MCP_TOOLS_PATH=my_tools uv run python -m berry_mcp

# Or run with built-in example tools
uv run python -m berry_mcp

Integración con VS Code

Agrega a tu .vscode/mcp.json:

{
  "inputs": [],
  "servers": {
    "my-custom-tools": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "python", "-m", "berry_mcp"],
      "env": {
        "BERRY_MCP_TOOLS_PATH": "my_tools"
      }
    }
  }
}

📖 Documentación

• Guía de Configuración de VS Code - Instrucciones completas de configuración
• Guía de Desarrollo de Herramientas - Crea herramientas personalizadas
• Documentación de API - Referencia técnica

🛠️ Herramientas Integradas

Berry MCP incluye herramientas de ejemplo para que comiences:

• Operaciones Matemáticas: add_numbers, generate_random
• Procesamiento de Texto: format_text, find_replace_text, encode_decode_text
• Información del Sistema: get_system_info, generate_uuid
• Herramientas de Datos: validate_json, generate_report
• Ejemplos Asíncronos: async_process_text

🔧 Uso Avanzado

Múltiples Fuentes de Herramientas

BERRY_MCP_TOOLS_PATH="my_tools,web_tools,data_processors" uv run python -m berry_mcp

Modo Servidor HTTP

uv run python -m berry_mcp --transport http --port 8080

Configuración de Entorno

export BERRY_MCP_SERVER_NAME="my-custom-server"
export BERRY_MCP_LOG_LEVEL="DEBUG"
export BERRY_MCP_TOOLS_PATH="my_tools,another_module.tools"
uv run python -m berry_mcp

🏗️ Arquitectura

Berry MCP sigue los principios SOLID con una arquitectura limpia y extensible:

• MCPServer: Orquestación central del servidor
• ToolRegistry: Gestión de herramientas basada en plugins
• Capa de Transporte: Comunicación abstraída (stdio/HTTP)
• Manejador de Protocolo: Procesamiento de mensajes JSON-RPC
• Framework de Herramientas: Creación de herramientas basada en decoradores

📋 Requisitos

• Python 3.10+
• Soporte del protocolo MCP
• Anotaciones de tipos para la generación automática de esquemas

🤝 Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de características: git checkout -b feature/amazing-feature
3. Realiza tus cambios siguiendo los patrones existentes
4. Agrega pruebas para la nueva funcionalidad
5. Ejecuta la suite de pruebas: pytest tests/
6. Envía una solicitud de extracción

📝 Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.

🙏 Agradecimientos

• Construido sobre el Protocolo de Contexto de Modelo
• Inspirado por la necesidad de facilitar la creación de servidores MCP
• Siguiendo principios de código limpio y patrones de diseño

---

🚀 ¡Comienza a crear tus herramientas MCP personalizadas hoy con Berry MCP Server!