Lumify Sports Intelligence

Lumify — 客户端 SDK 与 MCP

Lumify 的官方客户端库和 Model Context Protocol （MCP）集成。Lumify 是面向 Agent 的体育情报 API，提供实时赛程、实时比分、赔率、盘口变动、 公众投注比例，以及可解释的 AI 投注信心度，覆盖 MLB、NFL、 NCAAF、NCAAB、NBA、NHL、网球和足球（MLS、EPL、La Liga、 Serie A、Bundesliga、Ligue 1 和 UEFA Champions League）。

此存储库是客户端 SDK、MCP stdio 桥接程序以及开发者文档和示例的公开主页。Lumify 本身是托管式 API，位于 https://lumify.ai——你无需自行运行服务。

获取 API 密钥

此处的所有内容都使用 Lumify API 密钥（lmfy-...）进行身份验证。

• 最快——无需注册：前往 https://lumify.ai/docs/ai 获取免费即时试用密钥 （点击“Get instant trial key”）。无需账户、电子邮件或信用卡，可使用 100 个积分，有效期为 14 天。粘贴密钥即可开始调用。
• **长期账户：**在 https://lumify.ai/api-keys 创建密钥——免费试用含 1,000 个积分，无需信用卡。

export LUMIFY_API_KEY="lmfy-xxxxxx.yyyyyyyy"

软件包

运行时	软件包	安装	文档
TypeScript / JavaScript	@lumifyai/sdk	npm install @lumifyai/sdk	README
Python	lumify-sdk	pip install lumify-sdk	README
LangChain	langchain-lumify	pip install langchain-lumify	README
LlamaIndex	llamaindex-lumify	pip install llamaindex-lumify	README
CrewAI	crewai-lumify	pip install crewai-lumify	README
MCP stdio 桥接程序	@lumifyai/mcp	npx -y @lumifyai/mcp	README

快速入门

TypeScript

import { Lumify } from "@lumifyai/sdk";

const client = new Lumify({ apiKey: process.env.LUMIFY_API_KEY! });

const { sports } = await client.sports.list();
const event = await client.events.get(12345, { includeOdds: true, includeIntelligence: true });
console.log(event.status, event.intelligence?.bets);

Python

import os
from lumify import Lumify

client = Lumify(api_key=os.environ["LUMIFY_API_KEY"])

sports = client.sports.list()
event = client.events.get(12345, include_odds=True, include_intelligence=True)
print(event["status"], event.get("intelligence"))

curl

curl https://lumify.ai/v1/events?sport=nfl&status=inprogress \
  -H "Authorization: Bearer $LUMIFY_API_KEY"

在 AI Agent 中使用（MCP）

Lumify 在 https://lumify.ai/mcp 托管了 MCP 服务（Streamable HTTP、 JSON 模式、无状态）。将任何兼容 MCP 的客户端指向此服务即可。

远程（支持远程连接的 Cursor、VS Code、Claude Desktop）：

{
  "mcpServers": {
    "lumify": {
      "url": "https://lumify.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

本地 stdio（不支持远程 MCP 的客户端）：

{
  "mcpServers": {
    "lumify": {
      "command": "npx",
      "args": ["-y", "@lumifyai/mcp"],
      "env": { "LUMIFY_API_KEY": "YOUR_API_KEY" }
    }
  }
}

完整工具目录请参阅 MCP 桥接程序 README 和 MCP 指南。

示例

演示	路径	教程
实时体育比分板	examples/scoreboard	构建实时体育比分板

cd examples/scoreboard
npm install && cp .env.example .env   # set LUMIFY_API_KEY
npm start                             # → http://localhost:3000

文档

• API 参考： https://lumify.ai/docs/reference
• OpenAPI： https://lumify.ai/docs/openapi（架构：/openapi.json · ReDoc · Swagger UI）
• 指南（含 MCP）： https://lumify.ai/docs/guides
• 快速入门： docs/getting-started/quick-start.md
• Agent 指南集： docs/agent-cookbook.md
• Postman 集合： docs/lumify.postman_collection.json

支持与贡献

• 问题和错误： 提交 issue
• 贡献指南：CONTRIBUTING.md

许可证

MIT © 2026 Lumify AI