Chronos MCP Server

Servidor Chronos MCP 🔵

Chronos es un servidor de Protocolo de Contexto de Modelo (MCP) diseñado específicamente para la blockchain de Stellar y para su integración con Claude Desktop y aplicaciones de IA similares. Chronos dota a tu asistente de IA de herramientas en cadena que permiten interacciones optimizadas con la red Stellar.

Descripción general

Chronos MCP ofrece las siguientes capacidades:

• Conéctese a Stellar Wallets: conéctese de forma segura a su billetera usando una clave secreta.
• Listado de tokens de billetera: recupera y enumera todos los tokens guardados en una billetera Stellar.
• Consulta de saldos: obtenga saldos en tiempo real de su XLM y otros activos.
• Transferir fondos: inicie transferencias entre billeteras Stellar con facilidad.

Chronos está diseñado para ser extensible y funciona como un paquete Node.js estándar, lo que permite implementarlo, instalarlo e integrarlo fácilmente, de forma similar a otros servidores MCP como base-mcp.

Características

• Integración con Stellar: interactúa completamente con la red principal de Stellar a través de la API de Horizon.
• Implementación fácil: publique e instale Chronos usando npm.
• Compatibilidad con Claude Desktop: se integra perfectamente con Claude Desktop actualizando la configuración del servidor MCP.
• Arquitectura extensible: diseñada para futuras mejoras e integraciones de nuevas herramientas.

Prerrequisitos

• Node.js (v14 o superior)
• npm
• Credenciales de la billetera Stellar (clave secreta para la conexión)
• Conectividad a Internet para interactuar con la red Stellar

Instalación

Opción 1: Instalar desde npm (recomendado)

Instalar Chronos globalmente:

O úselo directamente con npx:

Opción 2: Instalar desde la fuente

1. Clonar el repositorio:
   git clone https://github.com/yourusername/chronos-mcp.git cd chronos-mcp
2. Instalar dependencias:
   npm install
3. Construir el proyecto:
   npm run build
4. (Opcional) Enlace global para un acceso más fácil:
   npm link

Opción 3: Usar Docker

También puedes ejecutar Chronos MCP usando Docker:

1. Construya la imagen de Docker:
   docker build -t chronos-mcp .
2. Ejecute el contenedor:
   docker run -it --rm chronos-mcp

Para obtener instrucciones más detalladas sobre el uso de Docker con Chronos MCP, incluida la configuración de Docker Compose y la integración con Claude Desktop, consulte la Guía de uso de Docker .

Para comprobar si su configuración de Docker funciona localmente, siga las instrucciones paso a paso de la Guía de pruebas de Docker . Esta guía incluye instrucciones para crear la imagen de Docker, ejecutar el contenedor y probar su funcionalidad.

Configuración

Variables de entorno

Chronos MCP utiliza variables de entorno para la configuración, especialmente para información confidencial como la clave secreta de Stellar. El proyecto utiliza dotenv para cargar variables de entorno desde un archivo .env durante el desarrollo.

Para configurar las variables de entorno:

1. Cree un archivo .env en la raíz del proyecto:
   STELLAR_SECRET_KEY=your_stellar_secret_key STELLAR_NETWORK=mainnet
2. Estas variables se cargarán automáticamente cuando se inicie la aplicación.

Al utilizar Docker, puede proporcionar variables de entorno de varias maneras:

• Uso del indicador --env-file : docker run -it --rm --env-file .env chronos-mcp
• Uso de la directiva env_file en docker-compose.yml
• Configuración de variables individuales con el indicador -e : docker run -it --rm -e STELLAR_SECRET_KEY=your_key chronos-mcp

Configuración del escritorio de Claude

Para utilizar Chronos con Claude Desktop, actualice el archivo de configuración de Claude Desktop ubicado en:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Ventanas: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Configuración de muestra para Claude Desktop:

Para la integración de Docker con Claude Desktop, puedes usar:

Uso

Chronos MCP expone las siguientes herramientas a través de su interfaz MCP:

conectar_billetera

Se conecta a una billetera Stellar usando la clave secreta.

Ejemplo de comando:

"Conectar mi billetera usando la clave secreta ______"

lista_de_tokens

Enumera todos los tokens y activos en la billetera Stellar especificada.

Ejemplo de comando:

"Listar mis tokens de billetera"

obtener_saldos

Recupera el saldo de XLM y cualquier otro activo.

Ejemplo de comando:

"¿Cuál es mi saldo XLM actual?"

transferencia_de_fondos

Transfiere fondos de tu billetera a otra billetera Stellar.

Parámetros:

• secretKey : la clave secreta de tu billetera.
• destinationAddress : la dirección de la billetera del destinatario.
• amount : La cantidad a transferir.
• asset(opcional) : activo a transferir (predeterminado XLM).

Ejemplo de comando:

"Transferir 0,5 XLM a [dirección de la billetera de destino]"

Pruebas

Pruebas estándar

Para probar Chronos MCP localmente:

Esto ejecutará el conjunto de pruebas del proyecto y verificará que su servidor esté funcionando como se espera.

Pruebas de Docker

Para probar la configuración de Docker localmente, consulte la Guía de Pruebas de Docker para obtener instrucciones detalladas. La guía cubre:

• Construyendo la imagen de Docker
• Ejecutar el contenedor con Docker Compose
• Probando la funcionalidad del contenedor
• Solución de problemas comunes

También puede utilizar el script test-client.js incluido para probar el contenedor Docker:

Este script envía una solicitud MCP simple al contenedor Docker y muestra la respuesta.

Despliegue

Chronos MCP está diseñado para funcionar como un paquete estándar de Node.js y puede publicarse en npm. Una vez publicado (por ejemplo, mediante npm publish ), Chronos puede instalarse globalmente o usarse mediante npx, como cualquier otro servidor MCP.

Para la implementación de producción, considere envolver Chronos en un servicio de sistema (usando systemd, launchd, etc.) para reinicios y monitoreo automáticos.

Extendiendo Chronos

Chronos se diseñó pensando en la extensibilidad. Para añadir nuevas herramientas:

1. Crea un nuevo directorio en la carpeta src/tools .
2. Implemente su herramienta (incluya un index.ts , schemas.ts y handlers.ts ).
3. Exporte su herramienta en src/tools/index.ts .
4. Actualice el README con la documentación y ejemplos de su herramienta.
5. Escriba pruebas para garantizar que su nueva herramienta funcione correctamente.

Licencia

Este proyecto está licenciado bajo la licencia MIT .

Contribuyendo

¡Agradecemos sus contribuciones! Consulte CONTRIBUTING.md para obtener información sobre cómo informar problemas, enviar solicitudes de incorporación de cambios y otras instrucciones para contribuir.

Este README está diseñado específicamente para Chronos MCP y describe su implementación como un paquete Node.js, integración con Claude Desktop y un conjunto completo de características para interactuar con la cadena de bloques Stellar.