Football Atlas

Football Atlas — MCP 服务

比赛规则与世界足球的主要赛事，每项说法均引用一手来源

一个基于精选知识图谱的远程 MCP 服务。它返回的每项说法都关联到已登记的来源：工具会将说法连同引用和置信度一并返回，让 Agent 能够展示依据，而不是直接断言。

无需安装。这是一个托管的可流式传输 HTTP 端点：

https://futbolatlas.app/mcp

也已在 Smithery 上列出。

将其添加到客户端

Claude Code

claude mcp add --transport http futbol-atlas https://futbolatlas.app/mcp

Claude Desktop / 任何读取 mcpServers 的客户端

{
  "mcpServers": {
    "futbol-atlas": {
      "type": "streamable-http",
      "url": "https://futbolatlas.app/mcp"
    }
  }
}

无需 API 密钥、账号或身份验证。只读。

无需任何客户端即可检查它是否能正常响应：

curl -s https://futbolatlas.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'mcp-protocol-version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

工具

共有 8 个工具，每个都有 outputSchema，且都会返回 structuredContent。

工具	参数	功能
get_overview	—	语料库概览：此实例掌握的内容、按类型统计的数量、已发布的标签和新鲜度。刚开始使用时，从这里入手，以判断此语料库是否能回答你的问题。
search	query, limit?	在知识图谱中进行全文搜索。搜索时不区分重音符号和撇号，因此可以使用用户自己的措辞进行查询；每条结果都附有相关性分数和匹配字段。
answer	question	根据语料库回答问题。返回匹配对象的说法、来源和置信度——绝不提供没有来源的答案。
get_entity	id	按 ID 获取一个知识对象及其说法和每项说法引用的来源。
get_topic	tag	列出带有某个标签的知识对象（主题是有内容支撑的标签）。
get_related	id	获取某个对象在图谱中的邻居：传出和传入关系，以及各自的关系类型。
get_sources	object_id?	获取完整的来源登记表，或仅获取某个对象引用的来源。可用它来评估语料库，再决定是否信任它。
get_latest	limit?	获取最近核验的知识对象，以了解内容的新鲜度。

建议的使用路径是 get_overview → search 或 answer → get_entity → get_related。设置 get_overview，是因为刚接入的 Agent 需要先了解此语料库是否能提供帮助，再花费一次调用进行猜测。

语料库包含的内容

知识对象	141
已登记来源	132
已发布主题	96

类型	对象数
实体	114
术语表	12
常见问题	7
指南	5
比较	3

内容主题：IFAB 制定的《比赛规则》十七条、VAR 协议及其复核类别、赛事赛制与晋级路径、越位、手球及决定判罚的具体措辞。

专为回答以下问题而构建

• 第 11 条关于球员在踢球瞬间所处的位置，具体是怎么规定的？
• VAR 何时可以介入，何时禁止介入？
• 球队如何晋级欧冠联赛阶段？

答案的实际形式

对线上端点进行一次真实调用——使用 answer 查询 "when can VAR intervene"——会返回以下 structuredContent，此处仅展示部分内容：

{
  "answered": true,
  "entity": {
    "id": "var",
    "name": "VAR (Video Assistant Referee)",
    "evidence_tier": "primary",
    "confidence": 0.94,
    "last_verified": "2026-08-08",
    "canonical_url": "https://futbolatlas.app/k/var"
  },
  "claims": [
    {
      "text": "The VAR may assist the referee only for a clear and obvious error or a serious missed incident in these match-changing categories: goal/no goal, penalty/no penalty, direct red card, and mistaken identity when the referee cautions or sends off the wrong player of the offending team.",
      "sources": [{ "title": "Video Assistant Referee (VAR) protocol (Laws of the Game 2026/27)" }]
    }
  ]
}

请注意答案附带的信息：证据等级、置信度、最后核验日期以及说法的来源——这些不是需要 Agent 解析的散文，而是 Agent 可以直接使用的字段。Agent 可以拒绝使用依据薄弱的说法，也可以直接引用一手来源。

如果语料库无法回答，answered 的值为 false。它不会编造答案，并会记录未命中的问题，以便补充缺失内容。

机器可读接口

MCP 端点只是其中之一。同一语料库也以纯文本文件的形式提供，Agent 可以直接读取：

接口	说明
/llms.txt	索引，格式为 text/plain
/llms-full.txt	合并在一个文件中的完整语料库
/ai-index.json	此实例发布的所有接口及其内容类型
/api/index.json	每个知识对象对应一份 JSON 文档
/api/sources.json	完整的来源注册表
/.well-known/mcp/server.json	此服务的清单

每个知识对象都有一个面向用户的页面，以及一个 ID 相同的机器可读版本；所有版本使用的规范 URL 都一致。

此仓库 server.json 中的 version

它是语料库版本，不是框架版本（ADR-017）：语料库新增 40 个对象后，必须能重新发布，而不必等人发布软件版本；框架补丁也不能让内容未变的语料库宣称有“新版本”。权威值以网站生成并提供的版本为准——/.well-known/mcp/server.json 中的 version 字段，以及 _citarium.corpus_version。

此仓库中的副本由人工维护，但已经发生偏差：网站提供的版本是 2026.809.141，而副本仍停留在 0.6.5。发布到 MCP Registry 之前，请复制网站提供的值。其他方面，这两个文件是有意设置为不相同的——此文件的远程地址带有 ?via=registry，而网站提供的版本带有 ?via=manifest，以便区分各渠道带来的流量。

集成前值得了解的行为

• 仅支持 POST。 其他所有方法都会返回 405，并带有 Allow: POST, OPTIONS 标头。
• 速率限制： 每个客户端每分钟 120 个请求，在共享存储中计数；每个响应都会公布 RateLimit-Limit、RateLimit-Remaining 和 RateLimit-Reset（三项都会通过 CORS 暴露）。 该机制采用故障开放策略：如果存储无法访问，请求仍会得到处理。
• 格式错误的输入会收到符合规范的 JSON-RPC 错误——无法解析的请求体返回 -32700，未知工具返回 -32602——绝不会返回 HTML 错误页面。
• 请求体有大小上限，且会在传输前进行验证。

隐私

不需要账户，不使用 Cookie，也没有广告。使用情况通过每日轮换的哈希标识符进行汇总统计，保留 200 天；原始 IP 永不存储。完整政策见：PRIVACY.md。

来源与许可

知识内容采用 CC-BY-4.0 许可：可以使用，但请注明出处。来源注册表公开的目的，正是让人们能够核查说法，而不是盲目信任——get_sources 会返回任意说法所依据的来源。

每项说法都标有证据等级和 last_verified 日期。证据较弱时，对象会如实说明，而不会夸大其证据等级。

构建方式

由 Citarium 编译并提供服务。Citarium 是一个源代码可用的框架，可在外部评估下，从单一来源将知识图谱转换为网站、API、MCP 服务以及 Agent 可读取的文件。

该框架的代码采用 Business Source License 1.1 许可，其仓库不公开。公开的内容——也是判断答案是否可信时真正重要的内容——是此服务、它提供的语料库，以及每项说法背后注册的来源：get_sources 会返回任意说法所依据的来源，供人们核查，而不是盲目信任。

此仓库是该服务对外公开的部分：它的清单和文档。语料库本身位于 futbolatlas.app。