⚽️ 基于FastMCP的足球数据微服务
该项目是一个安全且模块化的 足球数据微服务 使用 FastMCP 框架,旨在与无缝集成 LLM代理 喜欢 光标代理 和 克劳德桌面.
其目的是揭露 结构化实时足球数据 通过会话式、可调用的工具进行优化 代理工作流 --使自然语言驱动的数据检索变得容易和安全。
______________________________________________________________________
🚀 特性
- 🔌 FastMCP供电 具有模式兼容可调用工具的微服务。
- 🧠 与LLM代理无缝集成,用于自然语言查询。
- ⚙️ 集装箱化 码头工人 为了便携性和安全性。
- 🔐 双密钥访问控制,用于运行时保护。
- 📦 一键启动支持
config.json在克劳德桌面。
______________________________________________________________________
🧰 已实施的工具
每个工具都是一个符合MCP的函数,支持通过LLM进行模式驱动的查询,并返回干净、可解释的JSON结构。
- ###
get_league_id_by_name
- 检索a 联盟的唯一ID 按名字。 - 简化了需要数字联盟标识符的API调用。 - 启用自然语言驱动的动态查询。
- ###
get_standings
- 获取 详细排名 适用于多个联赛和赛季。 - 可选过滤方式 团队ID. - 非常适合比较团队绩效趋势。
- ###
get_player_id
- 解决 玩家ID 部分名字(名字或姓氏)。 - 返回与元数据(ID、年龄、国籍等)匹配的配置文件。 - 可用于处理来自LLM的不完整查询。
- ###
get_player_profile
- 交付 结构化玩家简历 (出生地、国籍、身高等)。 - 针对代理系统的个性化洞察量身定制。
- ###
get_player_statistics
- 胎儿全面 玩家统计 跨越季节。 - 指标包括进球、助攻、评分、传球、决斗、犯规等。 - 允许按联赛和赛季进行可选过滤。
______________________________________________________________________
🧱 架构与安全
🔒 安全、容器化部署
- 内置于 码头工人 用于一致的运行时、可移植性和代码保护。
- API密钥和凭据对日志和外部暴露是隐藏的。
- 通过自定义一键启动
config.json在克劳德桌面。
🔐 双钥匙访问控制
为防止误用和未经授权的访问:
- 🔑 内部密钥:在构建时嵌入Docker
.env文件。 - 🔑 外部密钥(运行时):必须由用户通过环境变量提供。
如果外部密钥可以 不匹配 内部秘密:
- 🚫 集装箱 立即退出.
- 🔐 内部密钥为 从未记录或公开.
这种强大的访问控制确保了安全部署,即使在共享或远程环境中也是如此。
______________________________________________________________________
🔧 技术栈
- FastMCP –LLM的模块化会话工具
- 码头工人 –集装箱化部署
- python –核心逻辑和工具
- RAPID-API足球 –实时足球数据源
- Claude桌面/光标代理 –基于LLM的接口
______________________________________________________________________
