内容
# Lumify — 客户端SDK与MCP
官方客户端库和 [模型上下文协议](https://modelcontextprotocol.io) （MCP）集成，适用于 [**Lumify**](https://lumify.ai)，即面向智能体育的API，提供实时赛程、比分、赔率、盘口变动、公众投注分布以及可解释的AI投注信心，涵盖MLB、NFL、NCAAF、NBA、NHL、网球和足球等体育项目。
> 本仓库是 **客户端SDK、MCP_stdio桥接器和开发者文档/示例** 的公开主页。Lumify本身是一个托管的API，位于 `https://lumify.ai` — 您无需自行运行服务器。
## 获取API密钥
此处所有内容均使用Lumify API密钥（`lmfy-...`）进行身份验证。在 **<https://lumify.ai/api-keys>** 创建一个密钥 — 免费试用，无需信用卡。
```bash
export LUMIFY_API_KEY="lmfy-xxxxxx.yyyyyyyy"
```
## 软件包
| 运行环境 | 软件包 | 安装 | 文档 |
|---|---|---|---|
| TypeScript / JavaScript | [`@lumifyai/sdk`](https://www.npmjs.com/package/@lumifyai/sdk) | `npm install @lumifyai/sdk` | [README](./clients/lumify-sdk/README.md) |
| Python | [`lumify-sdk`](https://pypi.org/project/lumify-sdk/) | `pip install lumify-sdk` | [README](./clients/lumify-sdk-python/README.md) |
| MCP_stdio桥接器 | [`@lumifyai/mcp`](https://www.npmjs.com/package/@lumifyai/mcp) | `npx -y @lumifyai/mcp` | [README](./clients/lumify-mcp/README.md) |
## 快速开始
### TypeScript
```ts
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
```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
```bash
curl https://lumify.ai/v1/events?sport=nfl&status=inprogress \
-H "Authorization: Bearer $LUMIFY_API_KEY"
```
## 从AI代理（MCP）使用
Lumify在 `https://lumify.ai/mcp` 运行了一个托管的MCP服务器（可流式传输的HTTP、JSON模式、无状态）。将任何MCP兼容的客户端指向它。
**远程（Cursor、VS Code、Claude Desktop with remote support）：**
```json
{
"mcpServers": {
"lumify": {
"url": "https://lumify.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
```
**本地stdio（不支持远程MCP的客户端）：**
```json
{
"mcpServers": {
"lumify": {
"command": "npx",
"args": ["-y", "@lumifyai/mcp"],
"env": { "LUMIFY_API_KEY": "YOUR_API_KEY" }
}
}
}
```
参见 [MCP桥接器README](./clients/lumify-mcp/README.md) 和 [MCP指南](https://lumify.ai/docs/guides#mcp) 以获取完整的工具目录。
## 文档
- **API参考：** <https://lumify.ai/docs/reference>
- **指南（包括MCP）：** <https://lumify.ai/docs/guides>
- **快速开始：** [`docs/getting-started/quick-start.md`](./docs/getting-started/quick-start.md)
- **代理食谱：** [`docs/agent-cookbook.md`](./docs/agent-cookbook.md)
- **Postman集合：** [`docs/lumify.postman_collection.json`](./docs/lumify.postman_collection.json)
## 支持与贡献
- 问题和错误： [打开一个问题](https://github.com/lumifyai/lumify/issues)
- 贡献指南： [`CONTRIBUTING.md`](./CONTRIBUTING.md)
## 许可证
[MIT](./LICENSE) 2026 Lumify AI
