FC 26 MCP

EA SPORTS FC 26용 MCP 서버입니다. Claude, Codex, Pi, Cursor, Cline, Windsurf 및 Model Context Protocol을 지원하는 모든 에이전트와 함께 작동합니다.

두 개의 서버가 포함되어 있습니다:

1. fc26-mcp-file — FBCHUNKS/T3DB 형식의 원시 Squads* 파일을 구문 분석하고 편집합니다.

2. fc26-mcp-live — 게임 실행 중 xAranaktu의 Live Editor Lua API를 통해 FC 26을 제어합니다.

설치

PyPI에서:

pip install fc26-mcp

GitHub에서:

pip install git+https://github.com/INSANE0777/Fc26-live-editor-mcp.git

소스에서:

git clone https://github.com/INSANE0777/Fc26-live-editor-mcp.git
cd fc26-mcp
pip install -e .

Related MCP server: MCP Partidos de Fútbol

GUI 편집기

스쿼드 파일을 열고 UI에서 완전히 편집할 수 있는 데스크톱 GUI(tkinter, 추가 종속성 없음)입니다. MCP 클라이언트나 Live Editor가 필요하지 않습니다:

fc26-mcp-gui                      # open via file dialog
fc26-mcp-gui "path/to/Squads..."  # open a specific squad file directly

기능:

• 모든 78개 DB 테이블에서 행 검색/편집/삭제 (테이블별 필터 상자)

• 이름 또는 ID로 플레이어 검색, 현재 클럽 및 임대 상태 표시

• 원클릭 이적 — 플레이어 + 대상 팀 선택, 모든 클럽 링크에 적용 (국가대표팀 링크는 자동으로 유지)

• 임대 종료 — playerloans 행 제거

• 저장 전 자동 백업 및 수동 백업 버튼

• 저장되지 않은 변경 사항 표시기; 저장 시 동일한 파일(또는 복사본)에 다시 씁니다.

참고: 스쿼드 파일의 dcplayernames 테이블은 불완전합니다(약 22,000명 중 약 6,000명). 따라서 많은 플레이어의 이름이 ?로 표시됩니다. 해당 플레이어는 플레이어 ID로 검색하세요.

경로

패키지는 플레이스홀더 경로를 사용합니다. 명령줄 플래그 또는 환경 변수를 통해 실제 경로를 설정하세요:

빠른 시작

1. 스쿼드 파일 MCP

fc26-mcp-file --squad-file "C:\Path\To\SquadsFile"

번들된 FC 26 메타데이터가 자동으로 사용됩니다. --meta-file로 재정의할 수 있습니다.

2. Live Editor MCP 브리지

1. FC 26을 실행하고 Live Editor를 주입합니다.

2. 커리어 모드를 로드합니다.

3. Lua 브리지를 Live Editor에 한 번 설치합니다:

fc26-mcp-live --install-lua "C:\Path\To\Your\FC 26 LE\lua\scripts"

4. Live Editor에서 Features → Lua Engine으로 이동하여 le_bridge.lua를 실행합니다.

5. MCP 서버를 시작합니다:

fc26-mcp-live --bridge-root "C:\Path\To\Your\FC 26 LE\le_bridge"

도구

파일 파서

• list_clubs

• search_players

• get_player_club

• plan_transfers

• apply_transfers

Live Editor 브리지 (28개 도구)

• 핵심: le_ping, le_list_clubs, le_search_players, le_get_player_club

• 이적/임대: le_transfer_player, le_loan_player, le_release_player, le_terminate_loan

• 리스트: le_add_to_transfer_list, le_add_to_loan_list, le_remove_from_lists, le_is_transfer_listed, le_is_loan_listed

• 플레이어 상태: le_set_player_sharpness, le_set_player_morale, le_set_player_form, le_set_player_fitness

• 예산: le_get_transfer_budget, le_set_transfer_budget

• 데이터베이스 편집기: le_get_db_tables, le_get_db_fields, le_get_db_rows, le_edit_db_field, le_insert_db_row, le_delete_db_row

• 통계: le_get_players_stats, le_get_player_stats

• 파워 유저: le_execute_lua

자세한 Live Editor 문서는 README_LE_BRIDGE.md를 참조하세요.

MCP 클라이언트 설정

mcp_config.json을 템플릿으로 사용하거나 다음 서버를 수동으로 추가하세요:

{
  "mcpServers": {
    "fc26-file": {
      "command": "fc26-mcp-file",
      "args": [
        "--squad-file",
        "C:\Path\To\SquadsFile"
      ]
    },
    "fc26-live": {
      "command": "fc26-mcp-live",
      "args": [
        "--bridge-root",
        "C:\Path\To\Your\FC 26 LE\le_bridge"
      ]
    }
  }
}

Claude Desktop

claude_desktop_config.json을 열고 위의 서버 블록을 추가하세요.

Cursor

Cursor Settings → MCP → Add MCP Server를 열고 명령어와 인수를 붙여넣으세요.

Cline / Roo Code

MCP 설정 파일에 JSON을 추가하세요.

Pi

Pi는 mcp_config.json 또는 작업 공간 설정에서 stdio MCP 서버를 감지합니다.

환경 변수

안전

• 편집하기 전에 항상 스쿼드 파일과 커리어 모드 저장 파일을 백업하세요.

• 커리어 모드 도구는 커리어 모드에서만 작동합니다.

• le_execute_lua는 임의의 코드를 실행할 수 있으므로 주의해서 사용하세요.

라이선스

MIT