Jellyfin API

MCP Server generated by mcp.ag2.ai

python

1

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nerdysouth-jellyfin-api": {
      "command": "python",
      "args": [
        "mcp_server/main.py",
        "stdio"
      ],
      "env": {
        "CONFIG": "JSON string containing the configuration",
        "SECURITY": "Environment variables for security parameters (e.g., API keys)",
        "CONFIG_PATH": "Path to a JSON configuration file (e.g., mcp_server/mcp_config.json)"
      }
    }
  }
}

You can run an MCP server that interfaces with Jellyfin's OpenAPI surface to coordinate multi-agent conversations. This server exposes a standard way for MCP clients to start, configure, and communicate with a Jellyfin-backed API, enabling automated workflows and agents to collaborate on data retrieval and actions.

How to use

To start using the MCP server, run it in stdio mode from your environment. The server accepts configuration via environment variables or a JSON config file, and you can connect MCP clients to it using the standard MCP transport.

Once the server is running, your MCP client can initiate conversations, send requests, and receive coordinated responses. Use the client’s normal flow to delegate tasks, query the Jellyfin API surface, and manage multi-agent dialogs within the provided runtime.

How to install

Prerequisites: Python 3.9+ and the ability to run pip and uv.

Step by step install flow you can follow on your machine.

pip install -e ".[dev]"

(Note: You can also install dependencies via an editable install using uv if preferred.)


## Available tools

### ruff

Linting and formatting tool for Python code, ensuring consistency and style adherence.

### mypy

Static type checker to catch type errors before runtime.

### pytest

Testing framework used to run unit and integration tests.

### pre-commit

Hooks that run automatically before each commit to catch issues early.

### hatch

Builds and publishes the MCP server package.