MCP Servers

K League API MCP

Enables querying K League official data (rankings, matches, players) via SQL using natural language, with a pre-built SQLite database.

README

K League API MCP

K리그 공식 Open API 데이터를 LLM이 SQL로 조회할 수 있게 해주는 MCP 서버입니다. 빌드된 SQLite DB(약 25MB)를 함께 배포하므로 API 키나 네트워크 없이 바로 동작합니다.

제공 도구 (tools)

도구	설명
`list_tables`	모든 데이터 테이블과 행 수 목록
`describe(table)`	테이블의 컬럼 목록
`docs()`	API 스펙 문서 (한글 필드 설명, 코드값 의미)
`query(sql)`	읽기 전용 SQLite SELECT 실행 (TSV 반환, 최대 1000행)

club_rank, match_info, player_info, match_player_record 등 22개 테이블을 포함합니다. 엔드포인트 1개 = 테이블 1개이며, 모든 값은 TEXT로 저장되어 있습니다.

설치

Python 3.10+ 필요.

git clone https://github.com/UoS-CIDA-Lab/k-league-api-mcp.git
cd k-league-api
pip install -r requirements.txt

DB는 data/kleague.sqlite3에 이미 포함되어 있어 별도 빌드가 필요 없습니다.

등록 방법

이 서버는 stdio로 통신합니다. 사용하는 클라이언트의 설정 파일에 아래 항목을 추가하세요. /absolute/path/to는 clone 받은 실제 경로로 바꿔야 합니다.

Claude Desktop

설정 파일 위치:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kleague": {
      "command": "python",
      "args": ["/absolute/path/to/k-league-api/kleague_mcp.py"]
    }
  }
}

저장 후 Claude Desktop을 재시작하면 도구가 나타납니다.

Claude Code

프로젝트 폴더에서 한 줄로 등록:

claude mcp add kleague -- python /absolute/path/to/k-league-api/kleague_mcp.py

Cursor / 기타 MCP 클라이언트

대부분의 클라이언트가 동일한 mcpServers JSON 형식을 사용합니다. 위 Claude Desktop 예시의 command / args를 해당 클라이언트의 MCP 설정에 그대로 넣으면 됩니다.

python이 PATH에 없거나 가상환경을 쓴다면 command를 해당 파이썬 절대경로 (예: /path/to/venv/bin/python)로 지정하세요.

사용 예시

등록 후 클라이언트에서 자연어로 물어보면 됩니다:

"K리그1 현재 순위를 알려줘"

LLM이 내부적으로 다음과 같이 호출합니다:

SELECT TEAM_NAME, RANK FROM club_rank ORDER BY CAST(RANK AS INT)

모든 컬럼이 TEXT이므로 숫자 정렬·연산 시 CAST(... AS INT)가 필요합니다. 컬럼 의미가 궁금하면 LLM이 docs()를 먼저 읽도록 되어 있습니다.

라이선스

데이터 출처: K League Open API.

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured