LiveScore MCP

io.github.holoduke由 GitHub 账号 holoduke 发布v1.3.1更新于 Oct 28, 2026

Football live scores, fixtures, standings, top scorers, matches, teams and players for 1000+ leagues

已验证Streamable HTTP可网页运行位置与生活网页搜索与抓取

概览

AI 生成的概览

免费的远程 MCP 服务器，让助手查询 1000 多个联赛的足球实时比分、赛程、积分榜、比赛详情及球队和球员数据。

可以做什么
  • 查询实时比分，以及按日期或赛事查看赛程，可按国家或联赛筛选
  • 读取联赛积分榜、射手榜和两队历史交锋记录
  • 查看单场比赛：事件、首发阵容、技术统计、伤病、状态、文字直播及赛后报道或赛前前瞻
  • 查看球队和球员资料，包括阵容、转会、身价和荣誉
  • 按名称搜索球队、球员和赛事，并用结果 id 获取完整详情
  • 获取球队队徽链接并检查连通性
适用场景
适合让助手回答足球相关问题，例如今日比分、联赛积分榜、某队阵容或赛程，而无需自行搭建数据管道。适用于个人非商业用途，可在任何支持远程 HTTP 端点的 MCP 客户端中使用。
运行要求
需要一个远程 Streamable HTTP 端点，旧版客户端可用 SSE 端点；无需 API 密钥或账号。可选参数可设置时区、语言和 JSON 输出。自行部署需要 Go 或 Docker，且仅用于开发和测试。
安装前请注意
仅限个人非商业免费使用，商业用途需获许可，禁止批量抓取或自动化采集数据。存在速率限制（每 IP 每分钟 30 次工具调用）。所有工具均为只读，但查询内容和请求 IP 会发送到托管服务，其数据来自 football-mania.com。

安装

在 SourceWeft 中

  1. 打开 控制台中的 LiveScore MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.holoduke%2Flivescore-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "livescore": {
      "type": "http",
      "url": "https://livescoremcp.com/mcp"
    }
  }
}

README

LiveScore MCP

Free Model Context Protocol server for real-time football scores, fixtures, team stats, and player data from 1000+ leagues worldwide.

livescoremcp.com

Quick Start

Connect any MCP client to the Streamable HTTP endpoint:

https://livescoremcp.com/mcp

Clients that only support the older SSE transport use https://livescoremcp.com/sse. No API key or account needed.

Claude Code

bash
claude mcp add --transport http livescore https://livescoremcp.com/mcp

Claude Desktop / claude.ai

Settings → Connectors → Add custom connector → https://livescoremcp.com/mcp

ChatGPT

Settings → Apps & Connectors → Create (developer mode) → https://livescoremcp.com/mcp, no authentication. search and fetch follow the format ChatGPT connectors and deep research require.

Cursor, Windsurf, VS Code, Cline and others

json
{  "mcpServers": {    "livescore": {      "url": "https://livescoremcp.com/mcp"    }  }}

Available Tools

ToolDescription
get_live_scoresMatches in play right now, with score and minute; filter by country or league
get_day_fixturesAll matches on a date (results, live, kick-off times); filter by country or league
get_league_fixturesA competition's latest results, live matches and upcoming fixtures, or one round
get_standingsLeague table: points, goal difference, form, qualification and relegation zones
get_top_scorersTop scorers of a competition
get_head_to_headAll-time record of two teams, recent meetings and their next meeting
get_matchMatch details: events, line-ups, substitutions, statistics, injuries, form, report and head-to-head
get_teamTeam profile: results, fixtures, squad, injuries, transfers, coach, stadium, honours
get_playerPlayer profile: statistics per season and competition, market value, injuries, transfers
searchFind teams, players and competitions; returns typed ids (team:9002, league:EnglandPremierLeague), titles and links
fetchFull details for an id from search (team, player, competition or match)
get_team_imageTeam logo URL
get_fixturesAlias of get_league_fixtures (kept for 1.0 clients)
get_match_reportWritten report of a finished match, or a preview of one to come, with its sources; translated into nine languages
get_match_commentaryMinute-by-minute commentary plus goals, cards and substitutions in order
healthConnectivity check

Tools that return a list or a report also set structuredContent alongside the text, described by the tool's outputSchema, so a client can read fields instead of parsing prose. The text itself is unchanged.

Answers are compact text written for language models: IDs for follow-up calls and a football-mania.com link for every match, team, player and competition. Every tool is read-only.

  • Names or IDs: teams, players and competitions can be passed by name ("Arsenal", "La Liga"); the best search match is used.
  • Time zones: pass timezone (IANA, e.g. Europe/London) and kick-off times and "today" follow it; the default is UTC.
  • Languages: language (en, es, de, fr, pt, pt-BR, ar, …) sets team and competition names and the language of the links.
  • Raw data: format: "json" returns the underlying feed.

Prompts

Clients that support MCP prompts offer these as ready-made commands:

PromptArguments
match_previewteam_a, team_b
league_roundupleague
team_reportteam
live_nowcountry (optional)

Example Queries

Once connected, just ask your AI assistant:

  • "What are the live scores right now?"
  • "Show me the Premier League table"
  • "Who are the top scorers in La Liga?"
  • "How did Barcelona do this week, and who do they play next?"
  • "Who scored in the Champions League tonight?"
  • "What matches are on this Saturday in Brazil?"
  • "Tell me about Ajax's squad and injuries"
  • "What's the head-to-head between Real Madrid and Barcelona?"

Data Source

All football data is provided by football-mania.com - a comprehensive football data platform covering 1000+ leagues and competitions worldwide with real-time scores, fixtures, team statistics, player profiles, and match details.

Football Mania is also available as a mobile app:

Usage Policy

LiveScore MCP is free for personal and non-commercial use.

  • Rate limits are enforced (30 tool calls/min per IP)
  • Bulk scraping and automated data harvesting are not allowed
  • Commercial use requires permission - open an issue to discuss

Tech Stack

  • Go with mcp-go
  • Streamable HTTP (/mcp, stateless) and SSE (/sse) transports
  • Deployed on Coolify

Self-Hosting

The football data comes from football-mania.com's own API, which serves the hosted instance at livescoremcp.com; a self-hosted copy is meant for development and testing.

bash
git clone https://github.com/holoduke/livescore-mcp.gitcd livescore-mcpgo build -o livescore-mcp .PORT=8080 ./livescore-mcp

Or with Docker:

bash
docker build -t livescore-mcp .docker run -p 8080:8080 livescore-mcp

License

MIT

来源：README.md，提交 d71ad1c

工具

16

fetch

Fetch a team, player, competition or match

Full details for an id from search: team:<id>, player:<id>, league:<league key> or match:<id>. Returns the title, the full text, and the football-mania.com url.

输入参数id必填languagetimezone

get_day_fixtures

Matches on a date

All football matches on a date: results, live scores and kick-off times, grouped by competition (biggest competitions first). A busy day has 1000+ matches, so filter by country or league_key when you can.

输入参数datelimitformatcountrylanguagetimezonetzoffsetleague_key

get_fixtures

Competition fixtures (alias)

Same as get_league_fixtures; accepts the competition key with or without the _small suffix.

输入参数limitroundformatlanguagetimezonecompetition必填

get_head_to_head

Head-to-head record

All-time head-to-head record of two teams: wins, draws, goals, their recent meetings and the next scheduled meeting. Teams by ID or name.

输入参数limitformatteam_a必填team_b必填languagetimezone

get_league_fixtures

Competition fixtures and results

Fixtures and results of one competition (league or cup): latest results, matches in play and upcoming matches of the current season, or one round. For the table use get_standings.

输入参数limitroundformatlanguagetimezoneleague_key必填

get_live_scores

Live football scores

Football matches being played right now, worldwide, with score and minute, grouped by competition (biggest competitions first). Optional filters by country or league key.

输入参数formatcountrylanguagetimezoneleague_key

get_match

Match details

One match in detail: score, status, goals, cards and substitutions with minutes, line-ups, team statistics (possession, shots, corners…), injuries, form, standings of both teams, match report and head-to-head record.

输入参数id必填h2hformatlanguagetimezone

get_match_commentary

Live commentary and events

Minute-by-minute written commentary for a match, plus the goals, cards and substitutions in order. Useful while a match is in play, and afterwards to see how it unfolded.

输入参数limitformatlanguagematch_id必填events_only

get_match_report

Match report or preview

A written report of a finished match, or a preview of one still to come, with the story and the sources it drew on. Available for selected competitions rather than every match; call get_match first if you are not sure the match has one. Translated into es, de, fr, it, pt, nl, ru, ar and tr; other languages fall back to English.

输入参数kindlanguagematch_id必填

get_player

Player profile

A player: club, position, age, nationality, market value, statistics per season and competition, injuries, transfers and honours.

输入参数id必填formatlanguage

get_standings

League table

Current standings (league table) of a competition: position, played, won, drawn, lost, goals, points, form and the qualification or relegation zone. Group-stage competitions return every group.

输入参数formatlanguageleague_key必填

get_team

Team profile

A team: recent results and upcoming fixtures, league positions, season statistics, squad with appearances and goals, injuries, transfers, coach, stadium and honours.

输入参数id必填squadformatlanguagetimezone

get_team_image

Team logo

URL of a team's logo (PNG).

输入参数id必填

get_top_scorers

Top scorers

Top scorers of a competition this season: goals, penalty goals, team and nationality.

输入参数limitformatlanguageleague_key必填

health

Connectivity check

Connectivity check: echoes the message back.

输入参数message

版本历史

2
  1. v1.3.1最新Oct 11, 2026
  2. v1.2.0Oct 11, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分