fc26-mcp 0.2.0__tar.gz

fc26_mcp-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Afjal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fc26_mcp-0.2.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md README_LE_BRIDGE.md LICENSE mcp_config.json
+recursive-include src/fc26_mcp/data *.xml
+recursive-include src/fc26_mcp *.lua

fc26_mcp-0.2.0/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.4
+Name: fc26-mcp
+Version: 0.2.0
+Summary: MCP servers for EA SPORTS FC 26 squad editing and Live Editor control
+Author: Afjal
+License: MIT
+Keywords: fc26,fifa,mcp,live-editor,squad-file,modding
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# FC 26 MCP
+
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+MCP servers for EA SPORTS FC 26. Works with Claude, Codex, Pi, Cursor, Cline, Windsurf, and any other agent that supports the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+Two servers are included:
+
+1. **`fc26-mcp-file`** — parses and edits raw `Squads*` files in FBCHUNKS/T3DB format.
+2. **`fc26-mcp-live`** — controls FC 26 through [xAranaktu's Live Editor](https://www.patreon.com/collection/1744905) Lua API while the game runs.
+
+---
+
+## Install
+
+From PyPI:
+
+```bash
+pip install fc26-mcp
+```
+
+From GitHub:
+
+```bash
+pip install git+https://github.com/INSANE0777/Fc26-live-editor-mcp.git
+```
+
+From source:
+
+```bash
+git clone https://github.com/INSANE0777/Fc26-live-editor-mcp.git
+cd fc26-mcp
+pip install -e .
+```
+
+---
+
+## Quick start
+
+### 1. Squad file MCP
+
+```bash
+fc26-mcp-file --squad-file "C:\Path\To\SquadsFile"
+```
+
+The bundled FC 26 metadata is used automatically. You can override it with `--meta-file`.
+
+### 2. Live Editor MCP bridge
+
+1. Launch FC 26 and inject Live Editor.
+2. Load Career Mode.
+3. Install the Lua bridge into Live Editor once:
+
+```bash
+fc26-mcp-live --install-lua "C:\Path\To\FC 26 LE v26.3.5\lua\scripts"
+```
+
+4. In Live Editor, go to **Features → Lua Engine** and run `le_bridge.lua`.
+5. Start the MCP server:
+
+```bash
+fc26-mcp-live --bridge-root "C:\Path\To\FC 26 LE v26.3.5\le_bridge"
+```
+
+---
+
+## Tools
+
+### File parser
+- `list_clubs`
+- `search_players`
+- `get_player_club`
+- `plan_transfers`
+- `apply_transfers`
+
+### Live Editor bridge (28 tools)
+- Core: `le_ping`, `le_list_clubs`, `le_search_players`, `le_get_player_club`
+- Transfers/loans: `le_transfer_player`, `le_loan_player`, `le_release_player`, `le_terminate_loan`
+- Lists: `le_add_to_transfer_list`, `le_add_to_loan_list`, `le_remove_from_lists`, `le_is_transfer_listed`, `le_is_loan_listed`
+- Player state: `le_set_player_sharpness`, `le_set_player_morale`, `le_set_player_form`, `le_set_player_fitness`
+- Budget: `le_get_transfer_budget`, `le_set_transfer_budget`
+- Database editor: `le_get_db_tables`, `le_get_db_fields`, `le_get_db_rows`, `le_edit_db_field`, `le_insert_db_row`, `le_delete_db_row`
+- Stats: `le_get_players_stats`, `le_get_player_stats`
+- Power user: `le_execute_lua`
+
+See [README_LE_BRIDGE.md](README_LE_BRIDGE.md) for detailed Live Editor docs.
+
+---
+
+## MCP client config
+
+Use `mcp_config.json` as a template, or add these servers manually:
+
+```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\FC 26 LE v26.3.5\le_bridge"
+      ]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Open `claude_desktop_config.json` and add the server blocks above.
+
+### Cursor
+
+Open **Cursor Settings → MCP → Add MCP Server**, paste the command and args.
+
+### Cline / Roo Code
+
+Add the JSON to your MCP settings file.
+
+### Pi
+
+Pi detects stdio MCP servers from `mcp_config.json` or your workspace settings.
+
+---
+
+## Environment variables
+
+| Variable | Purpose |
+|----------|---------|
+| `FIFA_SQUAD_FILE` | Default squad file path for `fc26-mcp-file` |
+| `FIFA_META_FILE` | Override bundled FC 26 metadata XML |
+| `FC26_BRIDGE_ROOT` | Bridge folder for `fc26-mcp-live` |
+
+---
+
+## Safety
+
+- Always back up your squad files and Career Mode saves before editing.
+- Career Mode tools only work inside Career Mode.
+- `le_execute_lua` can run arbitrary code — use it carefully.
+
+---
+
+## License
+
+MIT

fc26_mcp-0.2.0/README.md

@@ -0,0 +1,153 @@
+# FC 26 MCP
+
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+MCP servers for EA SPORTS FC 26. Works with Claude, Codex, Pi, Cursor, Cline, Windsurf, and any other agent that supports the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+Two servers are included:
+
+1. **`fc26-mcp-file`** — parses and edits raw `Squads*` files in FBCHUNKS/T3DB format.
+2. **`fc26-mcp-live`** — controls FC 26 through [xAranaktu's Live Editor](https://www.patreon.com/collection/1744905) Lua API while the game runs.
+
+---
+
+## Install
+
+From PyPI:
+
+```bash
+pip install fc26-mcp
+```
+
+From GitHub:
+
+```bash
+pip install git+https://github.com/INSANE0777/Fc26-live-editor-mcp.git
+```
+
+From source:
+
+```bash
+git clone https://github.com/INSANE0777/Fc26-live-editor-mcp.git
+cd fc26-mcp
+pip install -e .
+```
+
+---
+
+## Quick start
+
+### 1. Squad file MCP
+
+```bash
+fc26-mcp-file --squad-file "C:\Path\To\SquadsFile"
+```
+
+The bundled FC 26 metadata is used automatically. You can override it with `--meta-file`.
+
+### 2. Live Editor MCP bridge
+
+1. Launch FC 26 and inject Live Editor.
+2. Load Career Mode.
+3. Install the Lua bridge into Live Editor once:
+
+```bash
+fc26-mcp-live --install-lua "C:\Path\To\FC 26 LE v26.3.5\lua\scripts"
+```
+
+4. In Live Editor, go to **Features → Lua Engine** and run `le_bridge.lua`.
+5. Start the MCP server:
+
+```bash
+fc26-mcp-live --bridge-root "C:\Path\To\FC 26 LE v26.3.5\le_bridge"
+```
+
+---
+
+## Tools
+
+### File parser
+- `list_clubs`
+- `search_players`
+- `get_player_club`
+- `plan_transfers`
+- `apply_transfers`
+
+### Live Editor bridge (28 tools)
+- Core: `le_ping`, `le_list_clubs`, `le_search_players`, `le_get_player_club`
+- Transfers/loans: `le_transfer_player`, `le_loan_player`, `le_release_player`, `le_terminate_loan`
+- Lists: `le_add_to_transfer_list`, `le_add_to_loan_list`, `le_remove_from_lists`, `le_is_transfer_listed`, `le_is_loan_listed`
+- Player state: `le_set_player_sharpness`, `le_set_player_morale`, `le_set_player_form`, `le_set_player_fitness`
+- Budget: `le_get_transfer_budget`, `le_set_transfer_budget`
+- Database editor: `le_get_db_tables`, `le_get_db_fields`, `le_get_db_rows`, `le_edit_db_field`, `le_insert_db_row`, `le_delete_db_row`
+- Stats: `le_get_players_stats`, `le_get_player_stats`
+- Power user: `le_execute_lua`
+
+See [README_LE_BRIDGE.md](README_LE_BRIDGE.md) for detailed Live Editor docs.
+
+---
+
+## MCP client config
+
+Use `mcp_config.json` as a template, or add these servers manually:
+
+```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\FC 26 LE v26.3.5\le_bridge"
+      ]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Open `claude_desktop_config.json` and add the server blocks above.
+
+### Cursor
+
+Open **Cursor Settings → MCP → Add MCP Server**, paste the command and args.
+
+### Cline / Roo Code
+
+Add the JSON to your MCP settings file.
+
+### Pi
+
+Pi detects stdio MCP servers from `mcp_config.json` or your workspace settings.
+
+---
+
+## Environment variables
+
+| Variable | Purpose |
+|----------|---------|
+| `FIFA_SQUAD_FILE` | Default squad file path for `fc26-mcp-file` |
+| `FIFA_META_FILE` | Override bundled FC 26 metadata XML |
+| `FC26_BRIDGE_ROOT` | Bridge folder for `fc26-mcp-live` |
+
+---
+
+## Safety
+
+- Always back up your squad files and Career Mode saves before editing.
+- Career Mode tools only work inside Career Mode.
+- `le_execute_lua` can run arbitrary code — use it carefully.
+
+---
+
+## License
+
+MIT

fc26_mcp-0.2.0/README_LE_BRIDGE.md

@@ -0,0 +1,150 @@
+# FC 26 Live Editor MCP Bridge
+
+This MCP bridge lets an AI assistant control FC 26 **through Live Editor** while the game is running. It exposes most of the Live Editor Lua API as MCP tools.
+
+## Install
+
+```bash
+pip install fc26-mcp
+```
+
+## Files
+
+After installation:
+
+- `fc26-mcp-live` — MCP server command
+- `fc26_mcp/le_bridge.lua` — bundled Lua bridge script (installed with the package)
+
+You must copy `le_bridge.lua` into your Live Editor scripts folder once:
+
+```bash
+fc26-mcp-live --install-lua "C:\Path\To\FC 26 LE v26.3.5\lua\scripts"
+```
+
+## How it works
+
+1. MCP server receives a tool call.
+2. It writes a JSON command file to `le_bridge/in/{id}.json`.
+3. The Lua script running in Live Editor picks up the command, executes it via Live Editor's API, and writes the result to `le_bridge/out/{id}.json`.
+4. MCP server reads the result and returns it.
+
+## Setup
+
+1. Launch FC 26 and inject Live Editor.
+2. Load Career Mode.
+3. Open Live Editor → **Features → Lua Engine**.
+4. Load and execute `lua/scripts/le_bridge.lua`.
+   - You should see `[MCP Bridge] Full MCP bridge started` in the Live Editor log.
+5. Start the MCP server:
+
+```bash
+fc26-mcp-live --bridge-root "C:\Path\To\FC 26 LE v26.3.5\le_bridge"
+```
+
+## MCP client config
+
+```json
+{
+  "mcpServers": {
+    "fc26-live-editor": {
+      "command": "fc26-mcp-live",
+      "args": [
+        "--bridge-root",
+        "C:\Path\To\FC 26 LE v26.3.5\le_bridge"
+      ]
+    }
+  }
+}
+```
+
+## MCP tools
+
+### Core
+- `le_ping` — check bridge connection
+- `le_list_clubs` — list all teams
+- `le_search_players` — search players by name
+- `le_get_player_club` — show player's current club
+
+### Transfers / contracts
+- `le_transfer_player` — transfer to a club
+- `le_loan_player` — loan to a club
+- `le_release_player` — release to free agents
+- `le_terminate_loan` — end a loan
+- `le_add_to_transfer_list`
+- `le_add_to_loan_list`
+- `le_remove_from_lists`
+- `le_is_transfer_listed`
+- `le_is_loan_listed`
+
+### Player state (Career Mode)
+- `le_set_player_sharpness` (0-100)
+- `le_set_player_morale` (0-100)
+- `le_set_player_form` (0-100)
+- `le_set_player_fitness` (5-95)
+
+### Club budget
+- `le_get_transfer_budget`
+- `le_set_transfer_budget`
+
+### Database editor
+- `le_get_db_tables` — list accessible tables
+- `le_get_db_fields` — list fields of a table
+- `le_get_db_rows` — read rows from a table
+- `le_edit_db_field` — edit a field in a row
+- `le_insert_db_row` — insert a row
+- `le_delete_db_row` — delete a row
+
+### Stats
+- `le_get_players_stats`
+- `le_get_player_stats`
+
+### Power user
+- `le_execute_lua` — run arbitrary Lua code inside Live Editor (dangerous; use with care)
+
+## Example transfer
+
+```json
+{
+  "name": "le_transfer_player",
+  "arguments": {
+    "playerid": 220901,
+    "new_teamid": 2,
+    "transfersum": 0,
+    "wage": 0,
+    "contract_length": 60
+  }
+}
+```
+
+Or by name:
+
+```json
+{
+  "name": "le_transfer_player",
+  "arguments": {
+    "player": "Raya Martín",
+    "new_club": "Aston Villa"
+  }
+}
+```
+
+## Example database edit
+
+```json
+{
+  "name": "le_edit_db_field",
+  "arguments": {
+    "table": "players",
+    "match_field": "playerid",
+    "match_value": 220901,
+    "field": "overallrating",
+    "value": 99
+  }
+}
+```
+
+## Important
+
+- Career Mode tools only work inside **Career Mode**.
+- Always back up your Career Mode save before running transfers or DB edits.
+- The bridge times out after 30 seconds if the Lua script is not running.

fc26_mcp-0.2.0/mcp_config.json

@@ -0,0 +1,24 @@
+{
+  "mcpServers": {
+    "fc26-squad-file": {
+      "command": "fc26-mcp-file",
+      "args": [
+        "--squad-file",
+        "C:\Users\Afjal\AppData\Local\EA SPORTS FC 26\settings\SquadsFIFER'sBeta1xRODE'sNewSeasonModAlpha3"
+      ],
+      "env": {
+        "FIFA_SQUAD_FILE": "C:\Users\Afjal\AppData\Local\EA SPORTS FC 26\settings\SquadsFIFER'sBeta1xRODE'sNewSeasonModAlpha3"
+      }
+    },
+    "fc26-live-editor": {
+      "command": "fc26-mcp-live",
+      "args": [
+        "--bridge-root",
+        "C:\Users\Afjal\Downloads\Example folder - Copy\LE\FC 26 LE v26.3.5\le_bridge"
+      ],
+      "env": {
+        "FC26_BRIDGE_ROOT": "C:\Users\Afjal\Downloads\Example folder - Copy\LE\FC 26 LE v26.3.5\le_bridge"
+      }
+    }
+  }
+}

fc26_mcp-0.2.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fc26-mcp"
+version = "0.2.0"
+description = "MCP servers for EA SPORTS FC 26 squad editing and Live Editor control"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "Afjal"}
+]
+keywords = ["fc26", "fifa", "mcp", "live-editor", "squad-file", "modding"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Games/Entertainment",
+]
+
+[project.scripts]
+fc26-mcp-file = "fc26_mcp.mcp_server:main"
+fc26-mcp-live = "fc26_mcp.mcp_le_bridge:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+fc26_mcp = ["data/*.xml", "le_bridge.lua"]

fc26_mcp-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fc26_mcp-0.2.0/src/fc26_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""FC 26 MCP package."""
+
+__version__ = "0.2.0"