iGaming MCP：用于超个性化iGaming CRM的开源MCP服务器
欢迎来到存储库 iGaming MCP，一款革命性的模型上下文协议（MCP）服务器，旨在打破数据孤岛，为在线博彩行业带来真正的实时个性化。
此存储库为超个性化iGaming CRM提供了MCP服务器的参考实现，旨在实现实时、安全和道德的玩家参与。
什么是iGaming MCP？
iGaming MCP 是一个智能中间件层，连接iGaming平台、客户关系管理（CRM）系统和任何兼容MCP的AI代理。它为人工智能提供了在个人层面上理解玩家所需的工具和背景，并在所有接触点上编排超个性化的体验。把它看作是玩家参与的中枢神经系统。
我们解决的问题
在在线博彩行业中，玩家数据无处不在，但一次却不见踪影。实时投注 行为 在游戏平台上，历史数据在CRM中，营销活动是通过另一个工具运行的。这种碎片化成为现实 个性化 不可能，导致通用营销、错失机会和玩家流失。 iGaming MCP 通过为任何AI代理创建一个单一、统一的真相来源来解决这个问题。
核心功能：iGaming MCP工具集
iGaming MCP 通过开放的MCP标准公开了一组强大的工具和资源，允许AI代理执行复杂的操作。
|工具/资源名称|类型|描述|参数| AI代理用例示例| | :- | :- | :- | :- | :- | | get_player_360_查看 |资源|检索统一的玩家档案，将CRM数据（人口统计、LTV、VIP状态、通信历史）与平台数据（游戏偏好、存款历史）相结合。|player_id:string |一位AI代理问：“给我玩家'user-789'的完整个人资料，包括他们的 最喜欢的 游戏类别和最后的营销互动。" | | 获取高度_行为 |资源|获取玩家当前会话的实时馈送，包括正在玩的游戏、当前下注金额和会话时间。|player_id:string | AI代理监视玩家：“玩家'user-123'现在在做什么，他们玩了多久了？”| | predict_player_state |工具|使用人工智能模型预测关键参与者指标，如流失概率、次日存款可能性或未来LTV。|player_id：string，prediction_type：string（例如，'churn'，'ltv'）|人工智能代理评估一种情况：“根据玩家'user-456'的会话频率下降计算其7天的流失风险。”| | 推荐_下一步_测试_操作 |工具|生成排名列表 个性化 基于玩家的360度视图和预测状态的动作（例如，奖金优惠、游戏推荐、内容）。|player_id:string，context:string（例如，'session_end'，'new_login'）|AI代理试图吸引玩家：“为了鼓励第二次存款，向玩家'user-123'提供的最佳奖金是什么？”| | 触发器_全通道_电容器 |工具|通过指定渠道执行营销活动，例如发送 个性化 电子邮件、短信或应用内推送通知。|player_id:string，channel:string，campaign_id:string，content:object | AI代理决定采取行动：“向玩家'user-456'发送推送通知，并提供'ComeBackBonus'优惠。”| | 个性化_内容 |工具|动态 定制 玩家的用户界面，例如重新排序游戏大厅以展示首选游戏或显示 个性化 横幅。|player_id:string，element_id:string、content:object | AI代理定制体验：“重新排序玩家'user-789'的主大厅，首先显示'高波动性老虎机'。”| | 应用程序_游戏化_转发 |工具|发布基于游戏化的奖励，如忠诚度积分、奖品轮旋转或完成挑战的徽章。|player_id：string，reward_type：string，amount：int | AI代理奖励参与度：“连续第7天登录玩家'user-123'可获得500个忠诚度积分。”|
它是如何工作的：一个AI代理在行动
想象一下，一个AI代理的任务是减少玩家流失。使用 iGaming MCP，其思考过程可能如下：
- 检测问题：代理定期对活跃玩家运行predict_player_state。由于会话频率下降，它将玩家-456标记为高流失概率（75%）。
- 收集上下文：代理调用player-456的get_player_360_view。它学习玩家的 最喜欢的 游戏是“Ra之书”，他们的VIP级别是“黄金”，他们还没有回复最近两封电子邮件。
- 征求建议：代理使用玩家ID和上下文“high_churn_risk”调用recommend_next_best_action。这 iGaming MCP 服务器使用其内部模型推荐高价值、， 个性化 行动：“在Book of Ra上提供50次免费旋转，通过推送通知立即生效。”
- 采取行动：代理同意并调用trigger_omnichanel_campaign，指定推送通知通道和免费旋转优惠的内容。
- 确认和记录：执行该操作，并将交互记录回玩家的CRM配置文件，丰富他们对未来交互的360度视图。
用法
本地运行
- 安装依赖项：\
猛击\ pip安装-r要求.txt
- 启动服务器：\
猛击\ uvicorn run_server:应用程序--reload
服务器将在以下时间可用http://localhost:8000.
使用Docker Compose运行
- 构建并启动容器：\
猛击\ podman compose down&podman composer--文件停靠器-compose.yaml up--构建
或者使用Docker Compose：\ 猛击\ docker compose down&docker compose--文件docker-compose.yaml up--build
- 访问服务器：
- 着陆页: http://localhost:8000/ - 交互式API文档: http://localhost:8000/docs - 重新记录文档: http://localhost:8000/redoc - 健康检查: http://localhost:8000/health - 普罗米修斯指标: http://localhost:8000/metrics - MCP端点: http://localhost:8000/v1/mcp
MCP端点使用示例
所有请求都作为JSON-RPC 2.0 POST请求发送到/v1/mcp。 此演示不需要身份验证。
1.get_player_360_查看
猛击
curl-X POSThttp://localhost:8000/v1/mcp \\\ -H“内容类型：应用程序/json”\\\ -d'{“jsonrpc”：“2.0”，“方法”：“get_player_360_view”，“参数”：{“player_id”：“demo123”}，“id”：1}'
2.获取高度行为
猛击
curl-X POSThttp://localhost:8000/v1/mcp \\\ -H“内容类型：应用程序/json”\\\ -d'{“jsonrpc”：“2.0”，“方法”：“get_retime_behaviour”，“参数”：{“player_id”：“demo123”}，“id”：2}'
3.预测层状态
猛击
curl-X POSThttp://localhost:8000/v1/mcp \\\ -H“内容类型：应用程序/json”\\\ -d'{“jsonrpc”：“2.0”，“方法”：“predict_player_state”，“参数”：{“player_id”：“demo123”，“prediction_type”：“churn”}，“id”：3}'
安全、合规和运营考虑因素
作为用于iGaming的企业就绪MCP服务器， iGaming MCP 设计时考虑到了最高的安全、合规和卓越运营标准。
数据隐私和GDPR
- 默认情况下，所有个人数据都是模拟/演示的。对于生产环境，服务器支持静态和传输加密（TLS）。
- 数据保留和删除策略可配置，以满足GDPR和当地监管要求。
- 为数据主题请求提供了端点和管理工具，包括被遗忘权。
身份验证和授权
- 所有端点都支持OAuth2/JWT身份验证以实现安全访问。
- 严格的权限检查和用户上下文传播缓解了“混淆代理”问题。
可审计性
- 所有操作，特别是那些有副作用的操作（例如，活动触发、奖励），都会记录用户、时间戳和参数。
- 日志是不可变的，可以导出到SIEM或审计系统进行合规性和取证分析。
漏洞管理
- 开发管道集成了SAST和SCA，以识别代码和依赖关系中的漏洞。
- 所有组件都经过加密签名，以确保完整性。
操作可靠性
- 服务器是无状态的 集装箱化的，支持横向扩展和高可用性。
- 为编排和监控提供了健康检查和准备就绪端点。
监控和警报
- Prometheus兼容的指标端点可用于实时监控。
- 提供日志记录和错误警报挂钩，以便与您的监控堆栈集成。
业务和战略考虑
- 该解决方案基于开放标准和广泛采用的开源组件，最大限度地降低了成本和风险。
- 所有面向玩家的动作都可以使用人机交互控制，支持负责任的游戏和道德的人工智能。
- 可配置的规则可防止针对自我排斥或易受攻击的玩家。
参与进来！
iGaming MCP 目前正在开发中。我们相信开放标准和社区协作的力量。关注这个空间，寻找机会为未来做出贡献、测试和建设 个性化 iGaming。