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

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

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

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:

Define la función en el archivo src/__init__.py
Registra la herramienta en la función main()
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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servicio de precios de criptomonedas que proporciona información sobre precios de criptomonedas en tiempo real a través de un marco MCP (Protocolo de contexto de modelo) con integración de API de CoinMarketCap.

Python Server MCP

Integrations