SpaceTraders MCP服务器

一个Model Context Protocol (MCP)服务器,提供MCP客户端与SpaceTraders API的无缝集成,支持游戏状态自动化、分析和讨论。

  • by grantmd
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 grantmd/spacetraders-mcp

使用说明

太空贸易商MCP服务器

模型上下文协议(MCP)服务器,可在任何MCP客户端和SpaceTraders API之间提供无缝集成,实现对SpaceTraders游戏状态的当前状态的自动化、分析和讨论。

其中大部分是通过LLM工具作为个人实验“编写”的,考虑到目标受众,这可能并不奇怪,但我想提前明确这一点。

✨ 特性

  • 🤖 智能游戏助手:获取情境建议和战略建议
  • 📊 实时数据访问:自动访问您的船只、合同和系统
  • 🛠️ 自动化操作:通过自然语言执行复杂操作
  • 🗺️ 智能探索:智能系统映射和设施发现
  • 📈 战略分析:合同优化和车队管理建议
  • 🚢 高级船舶管理:具有实时冷却跟踪功能的单船监控
  • 📦 合同工作流程:完整的合同交付系统,包括增量货物交付

🚀 快速开始

先决条件

  • 达到1.21或更高
  • Java 8+和 OpenAPI生成器 (为 make build 关于新鲜克隆; brew install openapi-generator 在macOS上)
  • 任何MCP客户端
  • SpaceTraders API代币(在这里买一个)

安装

  1. 克隆存储库:

    git clone https://github.com/grantmd/spacetraders-mcp.git
    cd spacetraders-mcp
    
  2. 构建服务器 (如果需要,自动生成SpaceTraders API客户端):

    make build
    
  3. 设置您的SpaceStraders凭据:

    export SPACETRADERS_TOKEN=your_token_here
    
  4. 配置Claude Desktop(或其他客户端):

    编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (克劳德·麦克索斯):

    {
      "mcpServers": {
        "spacetraders": {
          "command": "/path/to/spacetraders-mcp/spacetraders-mcp",
          "args": []
        }
      }
    }
    
  5. 重新启动客户端 开始探索吧!

第一步

配置后,尝试以下命令:

  • “显示我当前的SpaceStraders状态” -获取完整概述
  • “我接下来应该探索哪些系统?” -获取战略建议
  • “帮助我优化我的车队” -分析和改进您的船只
  • “寻找最佳交易机会” -发现有利可图的路线

📖 文档

详细文档可在 docs/ 文件夹:

🎮 你能做什么

游戏管理

  • 检查代理状态、信用和车队概述
  • 监控船舶位置、货物和燃料液位
  • 实时船舶冷却监测 -确切地知道船只何时准备好行动
  • 单船分析 -全面的船舶状态和操作建议
  • 审查和管理合同
  • 增量合同交付 -多次按合同交付货物
  • 轨道系统探索进展

战略运营

  • 在航点和系统之间导航船舶
  • 提取资源并管理货物
  • 智能冷却管理 -围绕船舶可用性计划行动
  • 舰队协调 -监控多艘船的运行状态
  • 寻找最佳交易路线和机会
  • 购买和配置新船
  • 完整的合同工作流程 -高效地接受、交付和履行合同

智能辅助

  • 根据您当前的情况获取建议
  • 运行状态分析 -了解每艘船现在能做什么
  • 能力检测 -自动识别船舶角色(采矿、贸易等)
  • 分析设施和资源系统
  • 优化合同选择和完成策略
  • 行动计划 -根据船舶冷却和能力获取建议
  • 规划车队组成和扩张

🔗 示例工作流

合同交付工作流程:

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

车队冷却管理:

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

系统探索:

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

车队管理:

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

交易策略:

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

合同规划:

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

🆘 获取帮助

📜 许可证

Apache许可证-请参阅 许可证 了解详情。

🤝 贡献

欢迎投稿!请查看我们的 开发指南 了解如何开始的详细信息。