Servidor MCP de precios de metales

Un servidor MCP que proporciona precios actuales e históricos del oro/metales preciosos a través del servicio GoldAPI.io .

Características

Obtenga precios actuales del oro (XAU), la plata (XAG), el platino (XPT) y el paladio (XPD)
Soporte para múltiples monedas (USD, EUR, etc.)
Búsqueda opcional de precios históricos por fecha

Requisitos

Python 3.7+
Paquetes:
- mcp>=1.0.0
- requests>=2.31.0

Configuración

Clonar este repositorio
Instalar dependencias:
pip install -r requirements.txt
Establezca su clave API de GoldAPI.io como una variable de entorno:
export GOLDAPI_API_KEY="your_api_key_here"
(Usuarios de Windows: utilice set en lugar de export )

Uso

El servidor proporciona una herramienta MCP:

Instalación

Este servidor está diseñado para instalarse manualmente agregando su configuración al archivo cline_mcp_settings.json .

Agregue la siguiente entrada al objeto mcpServers en su archivo cline_mcp_settings.json :

"mcp_metal_price": {
  "args": [
    "/c",
    "python",
    "-m",
    "mcp_metal_price"
  ],
  "env": {
    "GOLDAPI_API_KEY": "Your GOLDAPI_API_KEY"
  }
}

obtener_precio_del_oro

Obtenga precios de metales actuales o históricos.

Parámetros:

currency (cadena, valor predeterminado: "USD"): Código de moneda (formato ISO 4217)
metal (cadena, valor predeterminado: "XAU"): Símbolo de metal (XAU, XAG, XPT, XPD)
date (cadena, opcional): fecha histórica en formato AAAAMMDD

Ejemplo de uso:

{
  "currency": "EUR",
  "metal": "XAU"
}

Ejecución del servidor

Inicie el servidor con:

python src/server.py

Uso con clientes MCP

Una vez que el servidor esté en funcionamiento, puedes conectarte a él desde clientes MCP como Cline o Claude.

Conectarse al servidor

El servidor se ejecuta en stdio por defecto. En su cliente MCP, puede conectarse usando:

cmd /c python src/server.py

Uso de la herramienta get_gold_price

Ejemplo de uso de herramientas en Cline/Claude:

<use_mcp_tool>
<server_name>gold-price</server_name>
<tool_name>get_gold_price</tool_name>
<arguments>
{
  "currency": "USD",
  "metal": "XAU"
}
</arguments>
</use_mcp_tool>

Formato de respuesta

El servidor devuelve datos de precios en formato JSON:

{
  "timestamp": 1713600000,
  "metal": "XAU",
  "currency": "USD",
  "price": 2345.67,
  "unit": "per troy ounce"
}

Licencia

Este proyecto está licenciado bajo los términos de la licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Metal Price MCP Server