Servidor Python MCP: Servicio de precios de criptomonedas

Este proyecto implementa un servidor MCP (Protocolo de Contexto de Modelo) que proporciona información sobre el precio de las criptomonedas. El servidor se creó con Python y el framework MCP para crear una API que puede ser utilizada por diferentes clientes.

Características

• Recuperación del precio de las criptomonedas en tiempo real

• Configuración basada en el entorno (desarrollo, producción, ensayo, local)

• Integración de la API de CoinMarketCap

• Implementación de contenedores Docker

Related MCP server: Coin MCP Server

Requisitos

• Python 3.12+

• uv (administrador de paquetes y entornos virtuales)

• Docker (opcional, para ejecución de contenedores)

Instalación

Uso de uv (recomendado)

# Clone the repository
git clone <repository-url>
cd PythonServerMcp

Crea y activa un entorno virtual con uv

uv venv
source .venv/bin/activate

Instalar dependencias

uv sync

Configuración

1. Cree un archivo .env en la raíz del proyecto con las siguientes variables:

ENVIRONMENT=DEV  # Options: LOCAL, DEV, STAGING, PROD
COINMARKETCAP_API_KEY=your_api_key_here

2. También puede crear archivos de entorno específicos para cada entorno:

   • .dev.env - Para el entorno de desarrollo

   • .staging.env - Para el entorno de ensayo

   • .prod.env - Para entorno de producción

Uso

Ejecución local

python main.py

Esto iniciará el servidor MCP que escuchará las solicitudes a través de la entrada/salida estándar (stdio).

Usando Docker

# Build the image
docker build -t test-mcp -f Dockerfile --platform linux/amd64 .

# Run the container
docker run -it test-mcp

Estructura del proyecto

.
├── Dockerfile          # Docker configuration
├── main.py             # Application entry point
├── pyproject.toml      # Dependencies configuration
├── start.sh            # Docker startup script
└── src/                # Source code
    ├── __init__.py     # MCP server initialization
    └── core/           # Core modules
        ├── common/     # Shared schemas and models
        ├── config.py   # Application configuration
        ├── services/   # Application services
        ├── settings/   # Environment-specific settings
        └── utils/      # Utilities

Desarrollo

Agregar nuevas herramientas al servidor MCP

Para agregar una nueva herramienta al servidor MCP, siga estos pasos:

1. Define la función en el archivo src/__init__.py

2. Registra la herramienta en la función main()

3. Documentar la herramienta con cadenas de documentación

Ejemplo:

@server.add_tool
def my_new_tool(parameter1: str, parameter2: int) -> str:
    """
    Description of what the tool does.
    
    Args:
        parameter1: Description of parameter 1
        parameter2: Description of parameter 2
        
    Returns:
        Description of what is returned
    """
    # Tool implementation
    return result