TraderGrader
⚠️ 正在进行中-谨慎使用 ⚠️
这是一个 实验性的 基于Rust-based MCP(Model Context Protocol,模型上下文协议)服务器,通过ESI API为人工智能工具提供对EVE在线市场数据、历史趋势和交易分析的访问。虽然与Claude Code和Claude Desktop一起运行,但该项目仍在积极开发中,如果有的话,应该小心使用。
🎯 什么是TraderGrader?
TraderGrader弥合了人工智能助手和EVE Online复杂的市场生态系统之间的差距。通过实施模型上下文协议,它允许人工智能工具查询实时市场数据,分析历史价格趋势,识别交易机会,并提供对新伊甸园经济的见解。
✅ 使用Claude Code的基本功能 -MCP服务器连接并响应基本查询,但全面的测试正在进行中。
模型上下文协议(MCP) 是一个 开放标准 这使得AI应用程序能够安全地与外部数据源和工具连接。TraderGrader实现了一个实验性的MCP服务器,该服务器将EVE Online市场数据作为AI助手的可调用工具公开。
⚡ 快速开始
单层衬里安装
curl -sSL https://raw.githubusercontent.com/fuuijin/tradergrader/main/scripts/install.sh | bash这会自动:
- 安装TraderGrader
~/.local/share/tradergrader - 构建优化的发布二进制文件
- 配置Claude Desktop集成
- 创建方便的CLI工具
手动安装
git clone https://github.com/fuuijin/tradergrader.git
cd tradergrader
cargo build --release
./scripts/install_mcp.sh # Configure for Claude Desktop🐳 Docker安装
Docker快速入门:
# Build and run with Docker
git clone https://github.com/fuuijin/tradergrader.git
cd tradergrader
./scripts/docker-build.sh
./scripts/docker-run.sh --interactive使用docker编写:
# Production setup
docker-compose up
# Development with Redis
docker-compose --profile with-redis up
# Development mode with hot reload
docker-compose --profile dev upDocker命令:
# Build optimized production image
./scripts/docker-build.sh
# Build development image (with Rust toolchain)
./scripts/docker-build.sh --dev
# Run interactively
./scripts/docker-run.sh --interactive
# Run health check
./scripts/docker-run.sh --health
# Test Docker setup
./scripts/docker-test.sh🛠️ 可用工具
TraderGrader提供5个MCP工具用于全面的市场分析:
核心市场数据
health_check-测试服务器连接和状态get_market_orders-当前买入/卖出订单数量和活动get_market_summary-实时价差价格分析
历史分析📈
get_market_history-历史价格数据(~400天)get_price_analysis-具有波动性的高级趋势分析
📊 特性
实时市场数据
- 当前市场订单和定价
- 买卖价差和利润率
- 多区域套利机会
- 订单量和市场活动
历史分析
- 价格趋势分析(每日/每周/每月变化)
- 使用标准偏差计算波动率
- 趋势分类(强向上/向下,稳定)
- 每个项目的历史数据跨度约为400天
交易情报
- 自动套利机会检测
- 利润率价差分析
- 市场活动监测
- 区域价格比较
🚀 用法
使用克劳德桌面
安装后,重新启动Claude Desktop并在对话中使用TraderGrader工具:
- *“吉塔氚市场分析”*
- *“查看PLEX上个月的价格趋势”*
- *“为技能注入者寻找有利可图的交易机会”*
- *“比较吉塔和阿马尔之间的Pyerite价格”*
CLI工具
# Market summary (default)
./market_query.sh -t 34 -r 10000002
# Price trend analysis
./market_query.sh --analysis -t 44992
# Historical data
./market_query.sh --history -t 35
# Current orders count
./market_query.sh --orders -t 36
# Help and options
./market_query.sh --help直接MCP集成
# Start MCP server
cargo run
# Send JSON-RPC commands
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_price_analysis","arguments":{"region_id":10000002,"type_id":44992}}}' | cargo run🏗️ 建筑
技术栈
- 语言:铁锈(2024年版)
- 协议:模型上下文协议(MCP)
- API:EVE在线ESI(EVE Swagger接口)
- 运输:基于标准输入的JSON-RPC
- 运行时:东京异步
- HTTP客户端:要求限速
核心组件
- MCP服务器:协议通信和工具调度
- ESI客户:具有适当用户代理和错误处理的HTTP客户端
- 市场分析:实时和历史数据分析
- CLI工具:直接使用的命令行实用程序
关键依赖关系
tokio-异步运行时reqwest-用于ESI API的HTTP客户端serde-JSON序列化/反序列化chrono-历史分析的日期/时间处理
📈 实例分析
价格趋势分析
Price Analysis for Type 44992 in Region 10000002:
Current Price: 6063000.00 ISK
Changes:
Daily: 0.00 ISK (+0.00%)
Weekly: -83000.00 ISK (-1.35%)
Monthly: -118000.00 ISK (-1.91%)
Volatility: 79716.97 ISK
Trend: Stable交易机会
Market Summary for Type 34 in Region 10000002:
Total Orders: 215
Buy Orders: 71
Sell Orders: 144
Highest Buy: 4.27 ISK
Lowest Sell: 2.70 ISK
Spread: -1.57 ISK🗺️ 常见EVE在线ID
主要贸易中心
- 10000002 -福吉(吉塔)-主要贸易中心
- 10000043 -Domain(Amarr)-主要贸易中心
- 10000032 -Sinq Laison(Dodixie)-区域枢纽
- 10000030 -Heimatar(Rens)-区域枢纽
热门交易项目
- 34 -氚(基本矿物)
- 35 -绿柱石(基本矿物)
- 44992 -技能注入器(高价值物品)
- 29668 -PLEX(游戏时间代币)
- 11399 -吗啡(稀有矿物)
⚠️ 技术考虑
速率限制
- ESI历史端点:每分钟每IP 300个请求
- 正确的错误处理和回退策略
- CCP要求的用户代理标识
数据质量
- 来自官方EVE ESI API的实时数据
- 每个项目约400天的历史数据
- 自动处理API停机和错误
🧪 测试
# Run unit tests
cargo test
# Run integration tests (makes real API calls)
cargo test -- --ignored
# Test specific functionality
cargo test test_price_analysis -- --ignored📁 项目结构
tradergrader/
├── src/
│ ├── main.rs # Application entry point
│ ├── lib.rs # Main application & public API (123 lines)
│ ├── types.rs # Data structures & types (50 lines)
│ ├── market.rs # Market logic & ESI API (199 lines)
│ └── mcp.rs # MCP protocol handling (411 lines)
├── tests/ # Integration tests
├── install.sh # One-liner installer script
├── market_query.sh # CLI utility for market queries
├── ROADMAP.md # Development roadmap
├── HISTORICAL_DATA.md # Historical features documentation
└── README_MCP.md # MCP-specific documentation🛣️ 发展路线图
✅ 已完成(v0.1.0)
- \[x\] 带stdio传输的生产MCP服务器
- \[x\] 实时市场数据获取
- \[x\] 历史价格数据和趋势分析
- \[x\] 价格波动和变化计算
- \[x\] 交易机会分析
- \[x\] 全面的CLI工具
- \[x\] 单行安装脚本
- \[x\] Claude桌面集成
🚧 下一阶段(v0.2.0)
- \[\]Redis缓存以提高性能
- \[\]多项目批量操作
- \[\]公司和联盟市场工具
- \[\]制造成本计算
- \[\]高级投资组合跟踪
🔮 未来阶段
- \[\]Web仪表板界面
- \[\]实时市场警报和通知
- \[\]机器学习价格预测
- \[\]与EVE角色API集成
- \[\]Docker容器化
📝 许可证
\[许可证待定\]
🤝 贡献
欢迎投稿!感兴趣的领域:
- EVE在线市场机制和交易策略
- Rust异步编程与优化
- MCP协议的扩展和改进
- 市场分析算法和统计数据
开发指南
- 遵循Rust习惯用法和惯例
- 为新功能添加全面的测试
- 遵守ESI费率限制和最佳实践
- 保持MCP协议合规性
📚 资源
EVE在线和市场数据
模型上下文协议
锈蚀发展
- Tokio异步运行时 -异步编程
- 请求HTTP客户端 -HTTP请求
- Serde JSON -序列化
______________________________________________________________________
_安全飞行,明智交易,明智获利。_ 🚀
状态:实验v0.1.0-小心使用| 最后更新:2025年6月
