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

Related MCP server: Frankfurter Forex MCP

Requisitos

• Python 3.7+

• Paquetes:

  • mcp>=1.0.0

  • requests>=2.31.0

Configuración

1. Clonar este repositorio

2. Instalar dependencias:

   pip install -r requirements.txt

3. 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 .

1. 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.