Behavioral Prediction MCP

🚀 行为预测MCP服务器

行为预测MCP服务器提供由人工智能驱动的工具，用于分析钱包行为预测、欺诈检测和跑路风险预测。开发者和平台可通过MCP协议集成这些工具，以保护DeFi用户、监控流动性风险，并对钱包或合约的可信度进行评分。

🚀 快速开始

此服务器为公共工具，但后端为私有。若要访问，需通过申请获取API密钥。

• 服务器URL：[https://prediction.mcp.chainaware.ai/]
• 代码仓库：[https://github.com/ChainAware/behavioral-prediction-mcp]

✨ 主要特性

• 提供AI驱动的钱包行为预测、欺诈检测和跑路风险预测工具。
• 所有工具遵循模型上下文协议（MCP），可通过兼容MCP的客户端使用。
• 与所有MCP客户端（Node、Python、浏览器）兼容，使用服务器发送事件（SSE）实现实时响应。

📦 安装指南

文档未提及安装步骤，若有需求，请参考代码仓库中的相关说明。

💻 使用示例

基础用法

Node.js示例

import { MCPClient } from "mcp-client";

const client = new MCPClient("https://prediction.mcp.chainaware.ai/");

const result = await client.call("predictive_rug_pull", {
  apiKey: "your_api_key",
  network: "BNB",
  walletAddress: "0x1234..."
});

console.log(result);

Python示例

from mcp_client import MCPClient

client = MCPClient("https://prediction.mcp.chainaware.ai/")

res = client.call("chat", {"query": "What is the rug pull risk of 0x1234?"})
print(res)

📚 详细文档

可用工具

1. 预测性欺诈检测工具

• ID：predictive_fraud
• 描述：此AI算法可在欺诈行为发生前预测给定钱包地址发生欺诈活动的可能性（准确率约98%），并进行反洗钱（AML）检查。当用户需要对区块链地址进行风险评估或早期预警时可使用。
• 示例用例：
  • 与vitalik.eth交互是否安全？
  • 此地址的欺诈状态如何？
  • 我的新钱包是否有被用于欺诈的风险？
• 输入参数： | 名称 | 类型 | 是否必需 | 描述 | | --------------- | ------ | -------- | ----------------------------------------------------------------- | | apiKey | 字符串 | ✅ | 用于身份验证的API密钥 | | network | 字符串 | ✅ | 区块链网络 (ETH, BNB, POLYGON, TON, BASE, TRON, HAQQ) | | walletAddress | 字符串 | ✅ | 要评估的钱包地址 |
• 输出（JSON）：

{
    "message": "string",              // 人类可读的状态消息
    "walletAddress": "string",        // 十六进制地址 
    "status": "Fraud",                // 欺诈状态 (Fraud, Not Fraud, New Address)
    "probabilityFraud": "0.00–1.00",  // 十进制概率
    "token": "string",                // 
    "lastChecked": "ISO‑8601 timestamp",
    "forensic_details": {             // 深度取证分析
    /* ...其他指标... */
    },
    "createdAt": "ISO‑8601 timestamp", 
    "updatedAt": "ISO‑8601 timestamp"
}

• 错误情况：
  • 403 Unauthorized → apiKey无效
  • 400 Bad Request → network或walletAddress格式错误
  • 500 Internal Server Error → 临时下游故障

2. 预测性行为分析工具

• ID：predictive_behaviour
• 描述：此AI驱动的引擎可预测钱包地址的意图或下一步可能的操作，分析其过去的链上历史，并提供个性化的操作建议。当需要进行以下操作时可使用：
  • 预测下一步最佳操作和意图（“此地址会进行存款、交易还是质押？”）
  • 评估风险承受能力和经验概况
  • 进行类别细分（如NFT、DeFi、跨链桥使用情况）
  • 根据历史模式提供定制化建议
• 示例用例：
  • 此地址下一步会做什么？
  • 用户是高风险还是有经验的用户？
  • 为ETH网络上的0x1234...推荐最佳的DeFi策略。
• 输入参数： | 名称 | 类型 | 是否必需 | 描述 | | --------------- | ------ | -------- | ----------------------------------------------------------------- | | apiKey | 字符串 | ✅ | 用于身份验证的API密钥 | | network | 字符串 | ✅ | 区块链网络 (ETH, BNB, BASE, HAQQ) | | walletAddress | 字符串 | ✅ | 要评估的钱包地址 |
• 输出（JSON）：

{
    "message": "string",              // 例如 “Success” 或错误信息
    "walletAddress": "string",        // 回显输入
    "status": "string",               // 欺诈状态 (Fraud, Not Fraud, New Address)
    "probabilityFraud": "0.00–1.00",  // 十进制欺诈分数
    "lastChecked": "ISO‑8601 timestamp",
    "forensic_details": {             // 深度取证分析
    /* ...其他指标... */
    },
    "categories": [ { "Category": "string", "Count": int }, … ],
    "riskProfile": [ { "Category": "string", "Balance_age": float }, … ],
    "segmentInfo": "JSON‑string of segment counts",
    "experience": { "Type": "Experience", "Value": int },
    "intention": {
        "Type": "Intentions",
        "Value": { "Prob_Trade": "High", "Prob_Stake": "Medium", … }
    },
    "protocols": [ { "Protocol": "string", "Count": int }, … ],
    "recommendation": { "Type": "Recommendation", "Value": [ "string", … ] },
    "createdAt": "ISO‑8601 timestamp",
    "updatedAt": "ISO‑8601 timestamp"
}

• 错误情况：
  • 403 Unauthorized → apiKey无效
  • 400 Bad Request → network或walletAddress格式错误
  • 500 Internal Server Error → 临时下游故障

3. 预测性跑路风险检测工具

• ID：predictive_rug_pull
• 描述：此AI引擎可预测哪些流动性池或合约未来可能会发生“跑路”情况。当需要在用户向风险池存款前发出警告或监控链上智能合约安全时可使用。
• 示例用例：
  • 如果我在这个新的DeFi池中质押资产，会发生跑路情况吗？
  • 监控我的流动性池头寸是否存在未来被利用的风险。
• 输入参数： | 名称 | 类型 | 是否必需 | 描述 | | --------------- | ------ | -------- | ------------------------------------------------- | | apiKey | 字符串 | ✅ | 用于身份验证的API密钥 | | network | 字符串 | ✅ | 区块链网络 (ETH, BNB, BASE, HAQQ) | | walletAddress | 字符串 | ✅ | 智能合约或流动性池地址 |
• 输出（JSON）：

{
  "message": "Success",
  "contractAddress": "0x1234...",
  "status": "Fraud",
  "probabilityFraud": 0.87,
  "lastChecked": "2025-10-25T12:45:00Z",
  "forensic_details": { /* 链上指标字典 */ }, 
  "createdAt": "2025-10-25T12:45:00Z",
  "updatedAt": "2025-10-25T12:45:00Z"
}

• 错误情况：
  • 403 Unauthorized → apiKey无效
  • 400 Bad Request → network或walletAddress格式错误
  • 500 Internal Server Error → 临时下游故障

服务配置

{
  "type": "http",
  "config": {
    "mcpServers": {
      "behavioural_prediction_mcp": {
        "type": "http",
        "url": "https://prediction.mcp.chainaware.ai/sse",
        "description": "The Behavioural Prediction MCP Server provides AI-powered tools to analyze wallet behaviour prediction,fraud detection and rug pull prediction.",
        "headers": {
          "x-api-key": ""
        },
        "params": {
          "walletAddress": "",
          "network": ""
        },
        "auth": {
          "type": "api_key",
          "header": "X-API-Key"
        }
      }
    }
  }
}

集成说明

• 与所有MCP客户端（Node、Python、浏览器）兼容。
• 使用服务器发送事件（SSE）实现实时响应。
• JSON模式与MCP规范匹配。
• 可能会有速率限制。
• 生产环境端点需要API密钥。

访问策略

MCP服务器的生产使用需要API密钥。若要申请访问：可通过https://chainaware.ai/pricing订阅列出的可用计划。

📄 许可证

客户端示例采用MIT许可证。服务器实现和后端逻辑为专有内容，保留私有。