SpaceTraders

Un servidor MCP para interactuar con la API de SpaceTraders, un juego de exploración y comercio espacial.

GitHub

Documentación

Servidor MCP de SpaceTraders

Go Reference

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una integración perfecta entre cualquier cliente MCP y la API de SpaceTraders, permitiendo automatización, análisis y discusión sobre el estado actual de tu juego de SpaceTraders.

La mayor parte de esto se está "escribiendo" mediante herramientas LLM como un experimento personal, lo cual probablemente no sorprenda dado el público objetivo, pero quería dejarlo claro desde el principio.

✨ Características

  • 🤖 Asistente de Juego Inteligente: Obtén consejos contextuales y recomendaciones estratégicas
  • 📊 Acceso a Datos en Tiempo Real: Acceso automático a tus naves, contratos y sistemas
  • 🛠️ Acciones Automatizadas: Ejecuta operaciones complejas mediante lenguaje natural
  • 🗺️ Exploración Inteligente: Mapeo inteligente de sistemas y descubrimiento de instalaciones
  • 📈 Análisis Estratégico: Optimización de contratos y recomendaciones de gestión de flota
  • 🚢 Gestión Avanzada de Naves: Monitoreo individual de naves con seguimiento de enfriamiento en tiempo real
  • 📦 Flujo de Trabajo de Contratos: Sistema completo de entrega de contratos con entrega incremental de bienes

🚀 Inicio Rápido

Requisitos Previos

  • Go 1.21 o superior
  • Java 8+ y OpenAPI Generator (para make build en clon nuevo; brew install openapi-generator en macOS)
  • Cualquier Cliente MCP
  • Token de API de SpaceTraders (Obtén uno aquí)

Instalación

  1. Clona el repositorio:

    git clone https://github.com/grantmd/spacetraders-mcp.git
cd spacetraders-mcp

  2. Compila el servidor (genera automáticamente el cliente de API de SpaceTraders si es necesario):

    make build

  3. Configura tus credenciales de SpaceTraders:

    export SPACETRADERS_TOKEN=your_token_here

  4. Configura Claude Desktop (u otro cliente):

    Edita ~/Library/Application Support/Claude/claude_desktop_config.json (Claude macOS):

    {
  "mcpServers": {
    "spacetraders": {
      "command": "/path/to/spacetraders-mcp/spacetraders-mcp",
      "args": []
    }
  }
}

  5. Reinicia tu cliente ¡y comienza a explorar!

Primeros Pasos

Una vez configurado, prueba estos comandos:

  • "Muéstrame mi estado actual de SpaceTraders" - Obtén una visión general completa
  • "¿Qué sistemas debería explorar a continuación?" - Obtén recomendaciones estratégicas
  • "Ayúdame a optimizar mi flota" - Analiza y mejora tus naves
  • "Encuentra las mejores oportunidades comerciales" - Descubre rutas rentables

📖 Documentación

Documentación detallada está disponible en la carpeta docs/:

🎮 Lo Que Puedes Hacer

Gestión del Juego

  • Verifica el estado del agente, créditos y visión general de la flota
  • Monitorea ubicaciones de naves, carga y niveles de combustible
  • Monitoreo de enfriamiento de naves en tiempo real - Sepa exactamente cuándo las naves están listas para acciones
  • Análisis individual de naves - Estado completo de la nave con recomendaciones operativas
  • Revisa y gestiona contratos
  • Entrega incremental de contratos - Entrega bienes a contratos en múltiples viajes
  • Rastrea el progreso de exploración de sistemas

Operaciones Estratégicas

  • Navega naves entre waypoints y sistemas
  • Extrae recursos y gestiona carga
  • Gestión inteligente de enfriamiento - Planifica acciones según la disponibilidad de naves
  • Coordinación de flota - Monitorea el estado operativo de múltiples naves
  • Encuentra rutas comerciales y oportunidades óptimas
  • Compra y configura nuevas naves
  • Flujos de trabajo completos de contratos - Acepta, entrega y cumple contratos eficientemente

Asistencia Inteligente

  • Obtén recomendaciones basadas en tu situación actual
  • Análisis de estado operativo - Comprende qué puede hacer cada nave en este momento
  • Detección de capacidades - Identificación automática de roles de naves (minería, comercio, etc.)
  • Analiza sistemas para instalaciones y recursos
  • Optimiza estrategias de selección y finalización de contratos
  • Planificación de acciones - Obtén sugerencias basadas en enfriamientos y capacidades de naves
  • Planifica la composición y expansión de la flota

🔗 Ejemplos de Flujos de Trabajo

Flujo de Trabajo de Entrega de Contratos:

1. "Check my contracts" - Review available and accepted contracts
2. "Show me ship TRADER-1 status" - Check ship location and cargo capacity
3. "Navigate TRADER-1 to the delivery location"
4. "Buy the required goods for the contract"
5. "Deliver goods to contract CONTRACT_123" - Incremental delivery
6. "Check cooldown for TRADER-1" - Monitor when ready for next action
7. "Fulfill the contract" - Complete and claim rewards

Gestión de Enfriamiento de Flota:

1. "Show me all ship cooldowns" - Monitor fleet availability
2. "Which ships are ready for mining?" - Find available extraction ships
3. "Check ship MINER-1 detailed status" - Comprehensive operational analysis
4. "Plan next actions based on cooldowns" - Strategic fleet coordination

Exploración de Sistemas:

"Explore system X1-DF55 and tell me what facilities are available"

Gestión de Flota:

"Where are all my ships and what should I do with them?"

Estrategia Comercial:

"Analyze my current cargo and find the best places to sell"

Planificación de Contratos:

"Review my contracts and suggest the most profitable completion order"

🆘 Obtener Ayuda

📜 Licencia

Licencia Apache - consulta LICENSE para más detalles.

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Consulta nuestra Guía de Desarrollo para detalles sobre cómo comenzar.