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

Related MCP server: pexbot-mcp

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.