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 分