Add Plex playback tool with configurable player aliases

[Teagan42]

What

• add Plex playback helpers and a play-media FastMCP tool that targets Plex clients by friendly name, machine id, or client id
• extend configuration to accept Plex connection settings and JSON friendly-name mappings for clients
• cover the new behaviour with configuration parsing tests and mocked playback integration tests
• bump the project version metadata

Why

• allow users to trigger playback for specific Plex players while supporting custom aliases for devices that report duplicate names

Affects

• Plex server tooling, configuration parsing, automated tests, and package metadata

Testing

• uv run ruff check .
• uv run pytest

Documentation

• Not needed

---

https://chatgpt.com/codex/tasks/task_e_68e0ff3a67148328b2baebe27bcc8041

[Copilot]

Pull Request Overview

Adds Plex playback capability with a new play-media tool, supporting player selection via friendly names, machine IDs, or client IDs, plus configurable aliases. Extends configuration to include Plex connection settings and alias parsing, with supporting tests and a version bump.

• Add Plex playback utilities and play-media FastMCP tool
• Extend Settings with Plex fields and alias JSON parsing
• Add configuration and playback integration tests; bump version metadata

Reviewed Changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
mcp_plex/server.py	Implements Plex playback logic, player discovery, identity caching, and new play-media tool.
mcp_plex/config.py	Adds Plex-related settings and JSON alias parsing validator.
tests/test_server.py	Adds playback integration tests (configuration required, alias resolution, capability enforcement).
tests/test_config.py	Adds tests for alias parsing and invalid alias handling.
pyproject.toml	Bumps project version for release.
docker/pyproject.deps.toml	Mirrors version bump in Docker dependency metadata.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
mcp_plex
config.py	33	6	82%	50, 52–55, 58
loader.py	565	6	99%	198, 253, 255–257, 273
server.py	592	28	95%	41–42, 117–118, 146, 250, 254, 275–278, 295, 353, 367, 385–386, 423, 1074, 1096–1102, 1138, 1156, 1161, 1179, 1303, 1340
TOTAL	1364	40	97%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	45.982s ⏱️