使用说明
⚽️ 基于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的接口
