SpaceTraders

Um servidor MCP para interagir com a API do SpaceTraders, um jogo de exploração e comércio espacial.

GitHub

Documentação

Servidor MCP SpaceTraders

Go Reference

Um servidor Model Context Protocol (MCP) que fornece integração perfeita entre qualquer cliente MCP e a API SpaceTraders, permitindo automação, análise e discussão sobre o estado atual do seu jogo SpaceTraders.

Grande parte disso está sendo "escrito" por meio de ferramentas de LLM como um experimento pessoal, o que provavelmente não é surpreendente dado o público-alvo, mas queria deixar isso claro desde o início.

✨ Recursos

  • 🤖 Assistente de Jogo Inteligente: Obtenha conselhos contextuais e recomendações estratégicas
  • 📊 Acesso a Dados em Tempo Real: Acesso automático às suas naves, contratos e sistemas
  • 🛠️ Ações Automatizadas: Execute operações complexas por meio de linguagem natural
  • 🗺️ Exploração Inteligente: Mapeamento inteligente de sistemas e descoberta de instalações
  • 📈 Análise Estratégica: Otimização de contratos e recomendações de gerenciamento de frota
  • 🚢 Gerenciamento Avançado de Naves: Monitoramento individual de naves com rastreamento de cooldown em tempo real
  • 📦 Fluxo de Trabalho de Contratos: Sistema completo de entrega de contratos com entrega incremental de mercadorias

🚀 Início Rápido

Pré-requisitos

  • Go 1.21 ou superior
  • Java 8+ e OpenAPI Generator (para make build em clone novo; brew install openapi-generator no macOS)
  • Qualquer Cliente MCP
  • Token da API SpaceTraders (Obtenha um aqui)

Instalação

  1. Clone o repositório:

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

  2. Compile o servidor (gera automaticamente o cliente da API SpaceTraders, se necessário):

    make build

  3. Configure suas credenciais SpaceTraders:

    export SPACETRADERS_TOKEN=your_token_here

  4. Configure o Claude Desktop (ou outro cliente):

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

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

  5. Reinicie seu cliente e comece a explorar!

Primeiros Passos

Após a configuração, experimente estes comandos:

  • "Mostre-me meu status atual no SpaceTraders" - Obtenha uma visão geral completa
  • "Quais sistemas devo explorar em seguida?" - Obtenha recomendações estratégicas
  • "Ajude-me a otimizar minha frota" - Analise e melhore suas naves
  • "Encontre as melhores oportunidades de negociação" - Descubra rotas lucrativas

📖 Documentação

Documentação detalhada está disponível na pasta docs/:

🎮 O Que Você Pode Fazer

Gerenciamento de Jogo

  • Verifique o status do agente, créditos e visão geral da frota
  • Monitore localizações de naves, carga e níveis de combustível
  • Monitoramento de cooldown de naves em tempo real - Saiba exatamente quando as naves estão prontas para ações
  • Análise individual de naves - Status abrangente da nave com recomendações operacionais
  • Revise e gerencie contratos
  • Entrega incremental de contratos - Entregue mercadorias em contratos em várias viagens
  • Acompanhe o progresso da exploração de sistemas

Operações Estratégicas

  • Navegue naves entre waypoints e sistemas
  • Extraia recursos e gerencie carga
  • Gerenciamento inteligente de cooldown - Planeje ações em torno da disponibilidade das naves
  • Coordenação de frota - Monitore o status operacional de várias naves
  • Encontre rotas e oportunidades de negociação ideais
  • Compre e configure novas naves
  • Fluxos de trabalho completos de contratos - Aceite, entregue e cumpra contratos com eficiência

Assistência Inteligente

  • Obtenha recomendações com base na sua situação atual
  • Análise de status operacional - Entenda o que cada nave pode fazer agora
  • Detecção de capacidades - Identificação automática de funções de naves (mineração, comércio, etc.)
  • Analise sistemas em busca de instalações e recursos
  • Otimize estratégias de seleção e conclusão de contratos
  • Planejamento de ações - Obtenha sugestões com base em cooldowns e capacidades das naves
  • Planeje a composição e expansão da frota

🔗 Exemplos de Fluxos de Trabalho

Fluxo de Trabalho 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

Gerenciamento de Cooldown da Frota:

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

Exploração de Sistemas:

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

Gerenciamento de Frota:

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

Estratégia de Negociação:

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

Planejamento de Contratos:

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

🆘 Obtendo Ajuda

📜 Licença

Licença Apache - veja LICENSE para detalhes.

🤝 Contribuindo

Contribuições são bem-vindas! Consulte nosso Guia de Desenvolvimento para detalhes sobre como começar.