MCP Server League of Legends

MCP Server League of Legends

用于实时访问《英雄联盟》电竞数据的 MCP（Model Context Protocol）服务。通过标准化接口提供有关正在进行的比赛、赛程、联赛、赛事详情和 VOD 的信息。

🚀 快速开始

1. 安装

# Clone and install dependencies
npm install

# Configure environment variables
cp .env.example .env

2. 配置

使用你的设置编辑 .env 文件：

# League of Legends eSports API Configuration
LOL_API_BASE_URL=https://esports-api.lolesports.com
LOL_API_KEY=your_api_key_here

# Server Configuration
HTTP_TIMEOUT=10000

3. 构建和运行

# Build
npm run build

# Run
npm start

# Or development with watch mode
npm run dev

⚙️ Cursor 配置

要在 Cursor 中使用此 MCP 服务，请配置 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "league-of-legends": {
      "command": "node",
      "args": ["./dist/index.js"],
      "cwd": "/path/to/your/mcp-server-lol",
      "env": {
        "NODE_ENV": "production",
        "LOL_API_BASE_URL": "https://esports-api.lolesports.com",
        "LOL_API_KEY": ""
      }
    }
  }
}

注意：将 /path/to/your/mcp-server-lol 替换为系统上的实际项目路径。

🛠️ 可用工具

工具	描述	参数
get-schedule	LoL 电竞赛程	language、leagueId（可选）
get-live-matches	正在进行的比赛	language
get-leagues	可用联赛	language、region（可选）
get-event-details	指定赛事详情	eventId、language
get-match-vods	比赛 VOD	eventId、language
get-upcoming-matches	即将开始的比赛	language、limit
get-live-match-score	实时战队比分	teamName、language

支持的语言

en-US、es-ES、fr-FR、de-DE、it-IT、pt-BR、ru-RU、tr-TR、ja-JP、ko-KR、zh-CN、zh-TW

📚 文档

如需了解功能、架构和高级用法的详细信息：

• 功能与特性 - 详细的功能说明和提示词模板
• API 参考 - 所有工具及参数的完整文档
• 项目结构 - 架构、技术栈和开发工作流

🔧 NPM 脚本

脚本	描述
npm run build	将 TypeScript 编译为 JavaScript
npm run dev	以监听模式进行开发
npm start	运行编译后的服务
npm run lint	运行代码检查
npm run format	使用 Biome 格式化代码
npm run check	完整的代码检查 + 格式化

🔒 安全

• 所有敏感配置均通过环境变量加载
• .env 文件已加入 .gitignore
• 必须验证关键变量
• 可配置 HTTP 请求超时时间

📄 许可证

GPL-3.0 - 详情请参阅 LICENSE 文件。