Football Atlas — MCP 서버

경기 규칙(Laws of the Game)과 세계 축구의 주요 대회, 모든 주장은 1차 출처로 인용됨

큐레이션된 지식 그래프 위에서 동작하는 원격 MCP 서버입니다. 이 서버가 반환하는 모든 주장은 등록된 출처에 바인딩됩니다. 도구는 주장을 인용 및 신뢰도 값과 함께 돌려주므로, 에이전트는 단정적으로 말하는 대신 근거를 제시할 수 있습니다.

설치할 것이 없습니다. 호스팅되는 streamable-HTTP 엔드포인트입니다:

https://futbolatlas.app/mcp

클라이언트에 추가하기

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"}'

Related MCP server: football-scraper-mcp

도구

각각 outputSchema를 가지며, 각각 structuredContent를 반환하는 8가지 도구가 있습니다.

권장 경로는 get_overview → search 또는 answer → get_entity → get_related입니다. get_overview가 존재하는 이유는 막 도착한 에이전트가 추측으로 호출을 낭비하기 전에 이 코퍼스가 도움이 될 수 있는지 알아야 하기 때문입니다.

코퍼스에 포함된 것

주제: IFAB가 작성한 경기 규칙 17개 조항, VAR 프로토콜 및 검토 범주, 대회 형식과 예선 경로, 오프사이드, 핸드볼, 그리고 이를 판정하는 문구.

답하도록 설계된 질문

• Law 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)" }]
    }
  ]
}

답변과 함께 전달되는 것을 주목하세요: 증거 등급, 신뢰도, 마지막 검증 날짜, 그리고 주장의 출처 — 에이전트가 파싱해야 하는 산문이 아니라, 에이전트가 직접 활용할 수 있는 필드로 제공됩니다. 에이전트는 약한 주장을 사용하지 않기로 결정하거나, 1차 출처를 직접 인용할 수 있습니다.

코퍼스가 답할 수 없을 때는 answered가 false입니다. 즉흥적으로 답하지 않으며, 누락은 기록되어 그 공백을 채울 수 있습니다.

기계가 읽을 수 있는 표면

MCP 엔드포인트는 여러 표면 중 하나입니다. 동일한 코퍼스가 에이전트가 직접 읽을 수 있는 일반 파일로도 제공됩니다:

각 지식 객체는 동일한 id에 사람용 페이지와 기계용 트윈 페이지를 가지며, 모든 표면에서 일치하는 표준 URL을 제공합니다.

통합 전에 알아두면 좋은 동작

• POST만 허용합니다. 다른 모든 메서드는 Allow: POST, OPTIONS 헤더와 함께 405로 응답합니다.

• 속도 제한: 클라이언트당 분당 120회 요청, 공유 저장소에서 집계되며 모든 응답에 RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset으로 게시됩니다(세 가지 모두 CORS로 노출). 열린 실패(open fail) 방식입니다: 저장소에 접근할 수 없으면 요청은 정상 처리됩니다.

• 잘못된 입력은 사양에 맞는 JSON-RPC 오류를 반환합니다 — 본문을 파싱할 수 없으면 -32700, 알 수 없는 도구면 -32602 — HTML 오류 페이지는 절대 반환하지 않습니다.

• 요청 본문은 크기가 제한되며 전송 전에 검증됩니다.

개인정보 보호

계정도, 쿠키도, 광고도 없습니다. 사용량은 일 단위로 회전하는 해시 식별자와 200일 보존 기간으로 집계 측정되며, 원시 IP는 절대 저장하지 않습니다. 전체 정책: PRIVACY.md.

출처 및 라이선스

지식 콘텐츠는 CC-BY-4.0입니다: 사용하고 인용하세요. 출처 레지스트리는 주장을 신뢰하는 대신 확인할 수 있도록 공개되어 있습니다 — get_sources는 특정 주장이 근거하는 바를 반환합니다.

주장에는 증거 등급과 last_verified 날짜가 포함됩니다. 증거가 약한 경우, 객체는 반올림하지 않고 그 사실을 명시합니다.

구축 방식

Citarium에 의해 컴파일되고 제공됩니다. 지식 그래프를 단일 소스에서 웹사이트, API, MCP 서버, 에이전트가 읽을 수 있는 파일로 변환하는 오픈소스 프레임워크입니다 — 외부 평가 중이며, 가디언과 위조 기록이 공개되어 있습니다.

이 저장소는 서버의 공개 인터페이스입니다: 매니페스트와 문서. 코퍼스 자체는 futbolatlas.app에 있습니다.