Freqtrade-MCP

Un servidor MCP que se integra con el bot de comercio de criptomonedas Freqtrade a través de su API REST, lo que permite una interacción fluida con el agente de IA para operaciones comerciales automatizadas.

Instalación

Prerrequisitos

• Python 3.13+ : asegúrese de que Python esté instalado en su sistema.
• Freqtrade : una instancia de Freqtrade en ejecución con la API REST habilitada (consulte la documentación de Freqtrade ).
• Git : para clonar el repositorio.

Pasos

1. Clonar el repositorio :
   git clone https://github.com/kukapay/freqtrade-mcp.git cd freqtrade-mcp
2. Instalar dependencias : usando pip :
   pip install freqtrade-client mcp[cli]
   O con uv (opcional):
   uv add freqtrade-client "mcp[cli]"
3. Configuración del cliente :
   "mcpServers": { "freqtrade-mcp": { "command": "uv", "args": [ "--directory", "/your/path/to/freqtrade-mcp", "run", "__main__.py" ], "env": { "FREQTRADE_API_URL": "http://127.0.0.1:8080", "FREQTRADE_USERNAME": "your_username", "FREQTRADE_PASSWORD": "your_password" } } }
4. Configuración de Freqtrade :Habilite el resto de la API agregando la sección api_server a su configuración y configurando api_server.enabled como verdadero.Configuración de muestra:
   "api_server": { "enabled": true, "listen_ip_address": "127.0.0.1", "listen_port": 8080, "verbosity": "error", "enable_openapi": false, "jwt_secret_key": "somethingrandom", "CORS_origins": [], "username": "Freqtrader", "password": "SuperSecret1!", "ws_token": "sercet_Ws_t0ken" },
   Consulte el documento aquí .

Uso

Herramientas disponibles

El servidor expone los siguientes puntos finales de la API de Freqtrade como herramientas MCP:

Ejemplos de indicaciones

1. Obtener datos del mercado :
   • "Muéstrame los datos de precios por hora de BTC/USDT".
   • "¿Cómo es el gráfico de 5 minutos de ETH/BTC?"
   • "Dame los últimos datos de velas del par XRP/USDT de la última hora".
2. Obtener estado del bot :
   • "¿Cuál es el estado actual de mis operaciones abiertas?"
   • "¿Hay alguna operación comercial activa en estos momentos?"
   • "Cuéntame sobre la actividad comercial del bot en este momento".
3. Obtener ganancias :
   • "¿Cuanto beneficio he obtenido hasta ahora?"
   • "¿Cuál es el resumen de ganancias totales del bot?"
   • "¿Puedes mostrarme mis ganancias comerciales?"
4. Obtener saldo :
   • "¿Cuál es el saldo de mi cuenta?"
   • "¿Cuánto dinero tengo en la cuenta de operaciones?"
   • "Dime el saldo actual de mi billetera Freqtrade".
5. Rendimiento de obtención :
   • "¿Qué tal ha funcionado el bot?"
   • "¿Cuáles son las métricas de rendimiento de mis operaciones?"
   • "Muéstrame las estadísticas comerciales".
6. Obtener lista blanca :
   • "¿Qué pares están en la lista blanca?"
   • "¿Qué pares comerciales puede utilizar el bot?"
   • "Enumere los pares incluidos en la lista blanca para mí".
7. Obtener lista negra :
   • "¿Qué pares están en la lista negra?"
   • "¿Qué pares comerciales están bloqueados en este momento?"
   • "Cuéntame sobre la lista negra."
8. Obtener transacciones :
   • "¿Cuál es el historial de mis operaciones cerradas?"
   • "Muéstrame todas las operaciones que ha completado el bot".
   • "¿Puedes enumerar mis operaciones pasadas?"
9. Obtener configuración :
   • "¿Cuál es la configuración actual del bot?"
   • "Muéstrame la configuración que está usando el bot".
   • "Cuéntame sobre la configuración de Freqtrade".
10. Obtener bloqueos :

• "¿Hay algún bloqueo comercial activo?"
• "¿Qué bloqueos están instalados actualmente?"
• "Muéstrame la lista de cerraduras comerciales".

11. Lugar de comercio :

• "Compra 0,01 BTC/USDT ahora mismo."
• "Venda 0,05 ETH/USDT inmediatamente."
• "Coloque una orden de compra por 0,1 XRP/USDT".

12. Iniciar bot :

• "Inicia el robot comercial".
• "Enciende el bot Freqtrade".
• "Pon el bot en funcionamiento ahora."

13. Detener el bot :

• "Detenga el robot comercial".
• "Apague el bot Freqtrade".
• "Pausar las operaciones del bot".

14. Recargar configuración :

• "Recargar la configuración del bot."
• "Actualizar la configuración del bot."
• "Actualizar la configuración de Freqtrade".

15. Añadir lista negra :

• "Poner en lista negra a ETH/USDT".
• "Agrega BTC/ETH a la lista negra".
• Negociación en bloque para XRP/USDT.

16. Eliminar lista negra :

• "Eliminar ETH/USDT de la lista negra".
• "Desbloquea BTC/ETH para operar".
• "Saquen XRP/USDT de la lista negra".

17. Eliminar bloqueo :

• "Eliminar el bloqueo comercial con ID 123."
• "Quitar el candado número 45."
• "Desbloquea el comercio con ID 7."

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.