Chiliz MCP

智利MCP

Chiliz区块链生态系统的高级模型上下文协议（MCP）服务器。具有用于粉丝代币管理、DeFi操作、体育分析和社交情绪跟踪的综合工具。

特性

核心区块链工具

• 实时价格跟踪：所有Chiliz粉丝代币的实时价格
• 钱包管理：余额检查、交易历史、投资组合分析
• 事务处理能力：发送CHZ、交换代币、批准支出
• 智能合约部署：部署ERC-20代币、NFT集合和自定义合约
• 区块链分析：网络统计、天然气价格、区块浏览器集成
• WebSocket监控：实时区块更新、待处理交易、合同事件

高级分析

• 智能资金追踪：鲸鱼运动、异常模式检测
• 令牌速度分析：交易量、流动性指标
• 社会情绪：推特/Reddit粉丝代币情绪分析
• 体育相关性：团队绩效对代币价格的影响

支持的粉丝代币

支持主要的Chiliz粉丝代币，包括：

• 欧洲俱乐部：巴黎圣日耳曼、巴塞罗那、尤文图斯、曼城、AC米兰、国际米兰
• 巴西俱乐部：弗拉门戈（MENGO）、科林蒂安（SCCP）、圣保罗（SPFC）、帕尔梅拉斯（VERDAO）
• 电子竞技：OG、Natus Vincere、异端团队
• 体育项目：UFC、PFL

FanX DEX集成

• 流动性池分析
• 最佳交换路由
• APY计算
• 永久性损失跟踪

🔐 企业安全

• 密钥管理器：AES-256-GCM加密私钥存储
• 交易签名者：使用确认回调进行安全交易签名
• 关键点旋转：支持基于ID的管理的多个加密密钥
• 环境保护：从环境或加密存储中安全处理密钥

🔄 高级错误处理和弹性

• 自动重试：瞬态故障的指数回退
• 断路器：持续错误的快速失败模式
• 自定义错误类型：全面的错误层次结构（NetworkError、RPCError、ValidationError等）
• 错误上下文：具有可重试状态和元数据的详细错误信息

⚡ 实时流媒体

• PriceStream：通过WebSocket自动重新连接实时更新价格
• 鲸鱼警报：大型交易通知的可配置阈值
• DEX活动：实时掉期和流动性事件监控
• 事件驱动：基于EventEmitter的灵活订阅架构

🔄 1英寸DEX聚合

• 多DEX路由：在多个DEX中找到最优惠的价格
• 交换优化：自动寻路以实现最佳执行
• 天然气估算：执行前成本分析
• 代币批准：简化审批事务生成

📊 高级分析工具

• 气体估算器：实时天然气价格建议（慢速/标准/快速）
• 交易成本分析：通过网络拥塞检测进行全面的成本细分
• 投资组合跟踪器：完整的投资组合分析，包括投资回报率、多样性得分和绩效指标
• 投资组合比较：多钱包分析和基准测试

🧪 生产就绪测试

• Jest框架：综合单元和集成测试
• 70%覆盖率目标：强制代码覆盖阈值
• ESM支持：现代JavaScript模块测试
• CI集成：对每次提交进行自动测试

🚀 CI/CD管道

• 自动化测试：跨节点18.x和20.x的矩阵测试
• 构建验证：TypeScript编译和类型检查
• 自动发布：发布时部署npm和GitHub包
• 发布自动化：变更日志生成和GitHub发布

📈 监测和可观察性

• 遥测系统：全面的指标收集（请求、错误、响应时间）
• 性能跟踪：p95/p99响应时间监测
• 健康检查：自动化系统运行状况
• 普罗米修斯出口：监控工具的标准度量格式

🐳 生产部署

• Docker支持：多阶段优化构建
• Docker Compose：全栈Redis、Prometheus和Grafana
• 健康检查：集装箱健康监测
• 非root用户：安全强化容器执行

安装

快速开始

1. 克隆仓库

git clone https://github.com/BrunoPessoa22/chiliz-mcp.git
cd chiliz-mcp

1. 安装依赖项

npm install

1. 配置环境

cp .env.example .env
# Edit .env with your configuration

1. 构建项目

npm run build

1. 启动MCP服务器

npm start

与Claude Desktop一起使用

1. 全局安装MCP服务器：

npm install -g chiliz-mcp

1. 添加到Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "chiliz-mcp": {
      "command": "node",
      "args": ["/path/to/chiliz-mcp/dist/index.js"],
      "env": {
        "CHILIZ_RPC_URL": "https://rpc.ankr.com/chiliz",
        "NETWORK": "mainnet"
      }
    }
  }
}

1. 重新启动克劳德桌面

配置

所需的环境变量

可选配置

可用工具

价格工具

• get_token_price -获取任何粉丝代币的当前价格
• get_price_history -历史价格数据与图表
• get_market_overview -市值排名和趋势

钱包工具

• get_wallet_balance -检查CHZ和代币余额
• get_transaction_history -地址的交易历史记录
• get_portfolio_value -投资组合总估值

交易工具

• send_chz -将CHZ发送到其他地址
• send_fan_token -转移粉丝代币
• swap_tokens -通过DEX在粉丝代币之间进行交换
• approve_token -批准代币支出

智能合约部署工具

• deploy_erc20_token -部署自定义ERC-20代币
• deploy_nft_collection -部署ERC-721 NFT集合
• deploy_custom_contract -部署任意Solidity合约

分析工具

• track_whale_movements -监控大额交易
• analyze_token_velocity -交易量分析
• detect_unusual_patterns -异常检测
• get_liquidity_metrics -DEX流动性分析
• estimate_gas -先进的天然气估算和成本分析
• get_gas_price_recommendations -获得缓慢/标准/快速的汽油价格
• analyze_transaction_cost -综合交易成本明细
• calculate_optimal_gas_price -根据紧急程度计算最佳气体
• track_portfolio -跟踪投资组合价值和分析
• get_portfolio_performance -投资回报率和绩效指标
• get_portfolio_diversity -多样性评分和建议
• compare_portfolios -比较多个钱包投资组合

1英寸DEX工具

• get_1inch_quote -从1英寸聚合器获取掉期报价
• get_1inch_swap -获取掉期交易数据
• get_1inch_tokens -列出支持的令牌
• get_1inch_liquidity_sources -获取可用的DEX资源
• find_best_route -在DEX之间找到最佳交换路线

社交和体育工具

• get_social_sentiment -推特/Reddit情绪
• get_team_performance -运动成绩相关性
• analyze_fan_engagement -社区指标

WebSocket实时监控

• start_block_monitoring -实时监控新区块
• start_log_monitoring -跟踪合同事件/日志
• start_pending_tx_monitoring -查看待处理交易
• monitor_fan_token_transfers -实时代币转移警报
• get_recent_blocks -检索最近的区块历史记录
• get_recent_logs -获取最近的合同事件
• get_recent_pending_transactions -查看待处理交易池
• get_websocket_status -检查连接状态
• stop_all_monitoring -停止所有实时订阅

发展

项目结构

chiliz-mcp/
├── src/
│   ├── tools/         # MCP tool implementations
│   ├── api/           # External API clients
│   ├── security/      # KeyManager & TransactionSigner
│   ├── errors/        # Error handling & retry logic
│   ├── streaming/     # Real-time PriceStream
│   ├── dex/           # 1inch DEX integration
│   ├── monitoring/    # Telemetry & metrics
│   ├── config/        # Configuration & validation
│   ├── types/         # TypeScript definitions
│   └── index.ts       # Main MCP server
├── tests/
│   ├── unit/          # Unit tests
│   └── integration/   # Integration tests
├── .github/workflows/ # CI/CD pipelines
├── docs/              # Documentation
├── landing-page/      # Documentation website
└── Dockerfile         # Docker deployment

运行测试

# Run all tests
npm test

# Run unit tests only
npm run test:unit

# Run integration tests only
npm run test:integration

# Run tests in watch mode
npm run test:watch

# Generate coverage report
npm run test:coverage

从源头构建

npm run build
npm run dev  # Development mode with watch

部署

将登录页面部署到Vercel

cd landing-page
npx vercel

部署到生产

1. 设置生产环境变量
2. 生产建设： npm run build:prod
3. 使用您喜欢的方法（Docker、PM2、systemd）进行部署

Docker部署

使用Docker Compose（推荐）:

# Start all services (MCP + Redis)
docker-compose up -d

# Start with monitoring stack (includes Prometheus + Grafana)
docker-compose --profile monitoring up -d

# View logs
docker-compose logs -f chiliz-mcp

# Stop all services
docker-compose down

直接使用Docker:

# Build image
docker build -t chiliz-mcp .

# Run container
docker run -d --name chiliz-mcp \
  -p 9090:9090 \
  -e CHILIZ_RPC_URL=https://rpc.ankr.com/chiliz \
  -e NETWORK=mainnet \
  chiliz-mcp

# Check health
docker ps
docker logs chiliz-mcp

文档

完整文档可在以下网址获得：https://chiliz-mcp.vercel.app

示例用法

// Get Flamengo token price
const price = await mcp.callTool('get_token_price', {
  symbol: 'MENGO'
});

// Check wallet balance
const balance = await mcp.callTool('get_wallet_balance', {
  address: '0x...',
  tokens: ['MENGO', 'SCCP']
});

// Swap tokens via FanX DEX
const swap = await mcp.callTool('swap_tokens', {
  tokenIn: 'CHZ',
  tokenOut: 'MENGO',
  amount: '100'
});

// Deploy ERC-20 token
const token = await mcp.callTool('deploy_erc20_token', {
  name: 'Flamengo Fan Token',
  symbol: 'MENGO',
  initialSupply: 1000000
});

// Deploy NFT collection
const nft = await mcp.callTool('deploy_nft_collection', {
  name: 'Match Highlights',
  symbol: 'HIGHLIGHT',
  maxSupply: 10000,
  baseTokenURI: 'ipfs://QmXxx/'
});

贡献

我们欢迎捐款！看 贡献.md 作为指导方针。

最近完成✅

• ✅ 1英寸DEX集成
• ✅ WebSocket实时更新
• ✅ 高级错误处理和重试逻辑
• ✅ 安全功能（密钥管理器、事务签名器）
• ✅ 投资组合跟踪和分析
• ✅ 70%覆盖率的测试套件
• ✅ CI/CD管道
• ✅ Docker部署
• ✅ 监测和遥测

当前优先领域

• 高优先级：多链支持（扩展到Chiliz以外）
• 高优先级：GraphQL API层
• 中等优先级：历史数据存储和分析
• 中等优先级：先进的NFT市场集成
• 低优先级：用于监控的UI仪表板

许可证

MIT许可证-请参阅 许可证 文件

链接

• Chiliz连锁店
• FanX DEX
• 文档
• 不和谐社区
• 报告问题

快速命令

# Install
npm install -g chiliz-mcp

# Check version
chiliz-mcp --version

# Run server
chiliz-mcp start

# Run tests
chiliz-mcp test

# View logs
chiliz-mcp logs

致谢

出于对Chiliz社区的热爱而建造。特别感谢所有巴西球迷！

______________________________________________________________________

备注：这是一个独立的项目，与Chiliz没有正式联系。始终验证智能合约地址，并在处理私钥时谨慎行事。