crypto-portfolio-mcp

Cartera de criptomonedas MCP

Un servidor MCP para rastrear y administrar las asignaciones de carteras de criptomonedas, que permite a los agentes de IA consultar y optimizar las estrategias de cartera en tiempo real.

Características

• Gestión de cartera : agregue y realice un seguimiento de sus tenencias de criptomonedas con precios de Binance en tiempo real.
• Recuperación de precios : obtenga los precios actuales de cualquier par comercial de Binance (por ejemplo, BTC/USDT).
• Historial de valores : genere gráficos visuales del valor de la cartera a lo largo del tiempo.
• Solicitud de análisis : Solicitud prediseñada para el análisis de cartera con sugerencias de diversificación y riesgo.
• Almacenamiento SQLite : almacenamiento persistente de existencias en una base de datos local.

Instalación

Prerrequisitos

• Python 3.10+
• Git (opcional, para clonar el repositorio)
• Un cliente MCP compatible (por ejemplo, Claude Desktop )

Configuración

1. Clonar el repositorio :
   git clone https://github.com/kukapay/crypto-portfolio-mcp.git cd crypto-portfolio-mcp
2. Requisitos de instalación :
   pip install mcp[cli] ccxt matplotlib
3. Instalar para Claude Desktop :
   mcp install main.py --name "CryptoPortfolioMCP"
   O actualice el archivo de configuración manualmente:
   { "mcpServers": { "crypto-portfolio-mcp": { "command": "python", "args": [ "path/to/crypto-portfolio-mcp/main.py" ] } } }

Uso

Una vez instalado, interactúe con el servidor mediante un cliente MCP como Claude Desktop. A continuación, se muestran ejemplos de comandos:

Agregar una tenencia

• Mensaje : "Añadir 0,1 BTC a mi cartera"
• Resultado : agrega 0,1 BTC/USDT a su cartera y confirma con "Se agregaron 0,1 BTC/USDT a la cartera".

Obtener precio actual

• Pregunta : "¿Cuál es el precio actual de ETH en Binance?"
• Resultado : Devuelve "Precio actual de ETH/USDT en Binance: $2000.50" (precio de ejemplo).

Resumen de la cartera

• Pregunta : "¿Cuál es el resumen actual de mi cartera?"
• Resultado : muestra un resumen formateado, por ejemplo:
  Portfolio Summary: BTC/USDT: 0.1 @ $60000.00 = $6000.00 ETH/USDT: 2.0 @ $2000.00 = $4000.00 Total Value: $10000.00

Historial del valor de la cartera

• Indicación : "Muéstrame el historial de valores de mi cartera"
• Resultado : genera y muestra un gráfico PNG del valor de su cartera a lo largo del tiempo.

Analizar cartera

• Indicación : "Analiza mi cartera de criptomonedas"
• Resultado : Proporciona un análisis con sugerencias basadas en las tenencias actuales y las tendencias del mercado de Binance.

Herramientas

El servidor expone las siguientes herramientas:

• get_portfolio_summary : recupera un resumen de texto de su cartera actual.
• add_holding(coin_symbol: str, amount: float) : agrega una tenencia de criptomonedas (por ejemplo, "BTC", 0.1).
• get_price(coin_symbol: str) : obtiene el precio actual de un par comercial de Binance.
• portfolio_value_history() : genera un gráfico PNG del historial de valores de la cartera.

Consulte las cadenas de documentación del código fuente para obtener descripciones detalladas de los parámetros.

Base de datos

Las tenencias se almacenan en una base de datos SQLite ( portfolio.db ) con el siguiente esquema:

Licencia

Este proyecto está licenciado bajo la licencia MIT. Consulte la LICENCIA para más detalles.