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

Configuración

Cree un archivo de configuración o configure las variables de entorno según sea necesario. Por ejemplo, para usar 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:

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

Para probar Chronos MCP localmente:

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

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.