使用说明
太空贸易商MCP服务器
模型上下文协议(MCP)服务器,可在任何MCP客户端和SpaceTraders API之间提供无缝集成,实现对SpaceTraders游戏状态的当前状态的自动化、分析和讨论。
其中大部分是通过LLM工具作为个人实验“编写”的,考虑到目标受众,这可能并不奇怪,但我想提前明确这一点。
✨ 特性
- 🤖 智能游戏助手:获取情境建议和战略建议
- 📊 实时数据访问:自动访问您的船只、合同和系统
- 🛠️ 自动化操作:通过自然语言执行复杂操作
- 🗺️ 智能探索:智能系统映射和设施发现
- 📈 战略分析:合同优化和车队管理建议
- 🚢 高级船舶管理:具有实时冷却跟踪功能的单船监控
- 📦 合同工作流程:完整的合同交付系统,包括增量货物交付
🚀 快速开始
先决条件
- 达到1.21或更高
- Java 8+和 OpenAPI生成器 (为
make build关于新鲜克隆;brew install openapi-generator在macOS上) - 任何MCP客户端
- SpaceTraders API代币(在这里买一个)
安装
-
克隆存储库:
git clone https://github.com/grantmd/spacetraders-mcp.git cd spacetraders-mcp -
构建服务器 (如果需要,自动生成SpaceTraders API客户端):
make build -
设置您的SpaceStraders凭据:
export SPACETRADERS_TOKEN=your_token_here -
配置Claude Desktop(或其他客户端):
编辑
~/Library/Application Support/Claude/claude_desktop_config.json(克劳德·麦克索斯):{ "mcpServers": { "spacetraders": { "command": "/path/to/spacetraders-mcp/spacetraders-mcp", "args": [] } } } -
重新启动客户端 开始探索吧!
第一步
配置后,尝试以下命令:
- “显示我当前的SpaceStraders状态” -获取完整概述
- “我接下来应该探索哪些系统?” -获取战略建议
- “帮助我优化我的车队” -分析和改进您的船只
- “寻找最佳交易机会” -发现有利可图的路线
📖 文档
详细文档可在 docs/ 文件夹:
- 资源 -可用数据资源及其使用方法
- 船舶资源 -单船监控和冷却跟踪
- 工具 -您可以通过Claude执行的操作
- 提示 -常见任务的智能辅助
- 整合 -Claude桌面设置和配置
- MCP资源指南 -了解MCP资源的工作原理
- 发展 -贡献和扩展服务器
- 测试 -运行测试和质量保证
- 故障排除 -常见问题和解决方案
- API 参考 -完整的API文件
- CI/CD -自动化工作流程和部署
🎮 你能做什么
游戏管理
- 检查代理状态、信用和车队概述
- 监控船舶位置、货物和燃料液位
- 实时船舶冷却监测 -确切地知道船只何时准备好行动
- 单船分析 -全面的船舶状态和操作建议
- 审查和管理合同
- 增量合同交付 -多次按合同交付货物
- 轨道系统探索进展
战略运营
- 在航点和系统之间导航船舶
- 提取资源并管理货物
- 智能冷却管理 -围绕船舶可用性计划行动
- 舰队协调 -监控多艘船的运行状态
- 寻找最佳交易路线和机会
- 购买和配置新船
- 完整的合同工作流程 -高效地接受、交付和履行合同
智能辅助
- 根据您当前的情况获取建议
- 运行状态分析 -了解每艘船现在能做什么
- 能力检测 -自动识别船舶角色(采矿、贸易等)
- 分析设施和资源系统
- 优化合同选择和完成策略
- 行动计划 -根据船舶冷却和能力获取建议
- 规划车队组成和扩张
🔗 示例工作流
合同交付工作流程:
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许可证-请参阅 许可证 了解详情。
🤝 贡献
欢迎投稿!请查看我们的 开发指南 了解如何开始的详细信息。