{"id":48093542,"url":"https://github.com/aserper/jellyseerr-mcp","last_synced_at":"2026-04-04T15:33:41.062Z","repository":{"id":311233246,"uuid":"1041850650","full_name":"aserper/jellyseerr-mcp","owner":"aserper","description":"An MCP server for jellyseerr","archived":false,"fork":false,"pushed_at":"2025-12-12T01:49:51.000Z","size":2518,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-23T14:43:10.956Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aserper.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-21T05:29:16.000Z","updated_at":"2025-12-19T05:46:09.000Z","dependencies_parsed_at":"2025-08-23T00:42:20.802Z","dependency_job_id":"55c9f8f9-de23-45cf-b48f-cb265f28da0d","html_url":"https://github.com/aserper/jellyseerr-mcp","commit_stats":null,"previous_names":["aserper/jellyseerr-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aserper/jellyseerr-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aserper%2Fjellyseerr-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aserper%2Fjellyseerr-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aserper%2Fjellyseerr-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aserper%2Fjellyseerr-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aserper","download_url":"https://codeload.github.com/aserper/jellyseerr-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aserper%2Fjellyseerr-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31403959,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-04T15:33:33.454Z","updated_at":"2026-04-04T15:33:39.989Z","avatar_url":"https://github.com/aserper.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Jellyseerr MCP Server](header.png)\n\n# Jellyseerr MCP Server\n\n[![Tests](https://img.shields.io/github/actions/workflow/status/aserper/jellyseerr-mcp/test.yml?style=for-the-badge\u0026logo=github\u0026label=Tests)](https://github.com/aserper/jellyseerr-mcp/actions/workflows/test.yml)\n[![Supported Python versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue.svg?style=for-the-badge\u0026logo=python\u0026logoColor=white)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](README.md#license)\n[![GHCR](https://img.shields.io/badge/ghcr.io-jellyseerr--mcp-blue?style=for-the-badge\u0026logo=docker\u0026logoColor=white)](https://github.com/aserper/jellyseerr-mcp/pkgs/container/jellyseerr-mcp)\n\n[![GitHub stars](https://img.shields.io/github/stars/aserper/jellyseerr-mcp.svg?style=social)](https://github.com/aserper/jellyseerr-mcp)\n[![GitHub forks](https://img.shields.io/github/forks/aserper/jellyseerr-mcp.svg?style=social)](https://github.com/aserper/jellyseerr-mcp/fork)\n\nAn MCP (Model Context Protocol) server for Jellyseerr that exposes Jellyseerr API functionality as MCP tools usable by LLM clients. It includes colorful, emoji-forward logging and clear console output.\n\n## Features\n- Exposes key Jellyseerr endpoints as MCP tools (search, request, get request status, etc.)\n- Synchronous HTTP client with robust error handling and timeouts\n- Colorful, structured logging via Rich with emoji indicators\n- Configuration via environment variables (`.env` supported)\n- Non-blocking stdio server compatible with multi-mcp configurations\n\n## Requirements\n- Python 3.10+\n- Packages in `requirements.txt`\n\n## Setup\n1. Create and activate a virtualenv.\n2. `pip install -r requirements.txt`\n3. Copy `.env.example` to `.env` and set your values.\n\n```\nJELLYSEERR_URL=https://your-jellyseerr.example.com\nJELLYSEERR_API_KEY=your_api_key_here\nJELLYSEERR_TIMEOUT=15\n```\n\n## Running the MCP server\n\n```\npython -m jellyseerr_mcp\n```\n\nYou should see colorful logs indicating the server is ready on stdio. The server communicates via stdin/stdout, making it compatible with Claude Desktop and other MCP clients.\n\n## Docker\n\nYou can run the server using Docker by either pulling the pre-built image from the GitHub Container Registry (GHCR) or building it yourself.\n\n### Pull from GHCR\n\n```bash\ndocker pull ghcr.io/aserper/jellyseerr-mcp:latest\n```\n\n### Build Locally\n\n```bash\ndocker build -t jellyseerr-mcp .\n```\n\n### Run\n\n```bash\n# If you pulled from GHCR:\ndocker run --rm -it \\\n  -e JELLYSEERR_URL=\"https://your-jellyseerr.com\" \\\n  -e JELLYSEERR_API_KEY=\"your_api_key\" \\\n  ghcr.io/aserper/jellyseerr-mcp:latest\n\n# If you built locally:\ndocker run --rm -it \\\n  -e JELLYSEERR_URL=\"https://your-jellyseerr.com\" \\\n  -e JELLYSEERR_API_KEY=\"your_api_key\" \\\n  jellyseerr-mcp\n```\n\n### Multi-MCP Configuration\n\nThe server is designed to work seamlessly with multi-mcp configurations. Example `mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"jellyseerr\": {\n      \"command\": \"/path/to/.venv/bin/python\",\n      \"args\": [\"-m\", \"jellyseerr_mcp\"],\n      \"env\": {\n        \"JELLYSEERR_URL\": \"https://your-jellyseerr.example.com\",\n        \"JELLYSEERR_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Exposed tools (initial set)\n- `search_media(query: str)` — Search Jellyseerr for media by query.\n- `request_media(media_id: int, media_type: str)` — Create a media request.\n- `get_request(request_id: int)` — Fetch a request’s details/status.\n- `ping()` — Liveness check with server/transport info.\n\nMore tools can be added easily — see `jellyseerr_mcp/server.py`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faserper%2Fjellyseerr-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faserper%2Fjellyseerr-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faserper%2Fjellyseerr-mcp/lists"}