add: annas-mcp package (Go, fakeHash placeholders)

- list_media: add offset and downloaded params for API pagination
- delete_media: new tool to delete downloaded files (with prevent_download option)
- Bump timeout on delete to 120s

.gitea/workflows/ci.yml

@@ -1,63 +1,22 @@
-name: CI
+name: NixOS Configuration CI
 
 on:
   push:
-    branches: [ main, master ]
+    branches:
+      - main
+      - master
   pull_request:
-    branches: [ main, master ]
+    branches:
+      - main
+      - master
 
 jobs:
-  flake-check:
+  check:
-    name: Flake Check
+    name: Nix Flake Check
-    runs-on: ubuntu-latest
+    runs-on: nixos
     steps:
-      - name: Checkout code
+      - name: Checkout Repository
         uses: actions/checkout@v4
 
-      - name: Install Nix
+      - name: Run nix flake check
-        uses: https://github.com/cachix/install-nix-action@v26
+        run: nix flake check --show-trace
-        with:
-          extra_nix_config: |
-            experimental-features = nix-command flakes
-            accept-flake-config = true
-
-      - name: Validate flake
-        run: nix flake check --print-build-logs
-
-  build-individual:
-    name: Build Individual Packages
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        package:
-          - academic-search-mcp-server
-          - duckduckgo-mcp-server
-          - kindly-web-search-mcp-server
-          - manim-mcp-server
-          - pdf-reader-mcp
-          - rust-research-mcp
-          - zotero-mcp
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Install Nix
-        uses: https://github.com/cachix/install-nix-action@v26
-        with:
-          extra_nix_config: |
-            experimental-features = nix-command flakes
-            accept-flake-config = true
-
-      - name: Build ${{ matrix.package }}
-        run: nix build .#${{ matrix.package }} --print-build-logs
-
-      - name: Test executable exists
-        run: |
-          if [ -e "./result/bin/${{ matrix.package }}" ]; then
-            echo "✓ Executable found: ${{ matrix.package }}"
-            ./result/bin/${{ matrix.package }} --help || true
-          else
-            echo "⚠ No executable found at ./result/bin/${{ matrix.package }}"
-            ls -la ./result/bin/ || echo "No bin directory"
-          fi

.gitignore

@@ -27,3 +27,4 @@ result-*
 # Local environment overrides
 .envrc.local
 /.dir-locals.el
+__pycache__/

README.md

@@ -6,21 +6,27 @@ This repository provides Nix derivations for MCP (Model Context Protocol) server
 
 ## Available Packages
 
-| Package                      | Description                                                   | Language   |
+| Package                          | Description                                                          | Language   |
-|------------------------------|---------------------------------------------------------------|------------|
+| -------------------------------- | -------------------------------------------------------------------- | ---------- |
-| academic-search-mcp-server   | Search academic papers via Semantic Scholar and Crossref      | Python     |
+| academic-search-mcp-server       | Search academic papers via Semantic Scholar and Crossref             | Python     |
-| duckduckgo-mcp-server        | Web search and content fetching via DuckDuckGo                | Python     |
+| annas-mcp                        | Anna's Archive MCP server                                            | Python     |
-| kindly-web-search-mcp-server | Web search + content retrieval via Serper, Tavily, or SearXNG | Python     |
+| applemusic-mcp                   | Apple Music — manage playlists, search catalog, browse library       | Python     |
-| manim-mcp-server             | Execute Manim animation code and return videos                | Python     |
+| duckduckgo-mcp-server            | Web search and content fetching via DuckDuckGo                       | Python     |
-| n8n-mcp                      | AI access to n8n node docs and workflow management            | TypeScript |
+| jellyfin-mcp                     | MCP server for Jellyfin media server                                 | Python     |
-| pdf-reader-mcp               | Production‑ready PDF processing with parallel processing      | TypeScript |
+| kindly-web-search-mcp-server     | Web search + content retrieval via SearxNG, Tavily, or SearXNG       | Python     |
-| rust-research-mcp            | Accumulate and organize academic knowledge                    | Rust       |
+| manim-mcp-server                 | Execute Manim animation code and return videos                       | Python     |
-| simple-web-search-mcp        | Zero-config web search and page reading for LLMs              | TypeScript |
+| mcp-arr-server                   | MCP server for *arr suite — Sonarr, Radarr, Lidarr, Prowlarr         | TypeScript |
-| mcp-arr-server               | MCP server for *arr suite — Sonarr, Radarr, Lidarr, Prowlarr | TypeScript |
+| mcp-score                        | AI-driven music score generation and MuseScore live control          | Python     |
-| transmission-mcp             | MCP server for the Transmission BitTorrent client             | Python     |
+| n8n-mcp                          | AI access to n8n node docs and workflow management                   | TypeScript |
-| sabnzbd-mcp                  | MCP server for SABnzbd download management                   | Python     |
+| nextcloud-mcp-server             | Nextcloud MCP server (files, calendar, contacts, deck, etc.)         | Python     |
-| jellyfin-mcp                 | MCP server for Jellyfin — search, playback, metadata, admin  | Go         |
+| pdf-reader-mcp                   | Production‑ready PDF processing with parallel processing             | TypeScript |
-| zotero-mcp                   | Connect Zotero research library with AI assistants            | Python     |
+| rust-research-mcp                | Accumulate and organize academic knowledge                           | Rust       |
+| simple-web-search-mcp            | Zero-config web search and page reading for LLMs                     | TypeScript |
+| transmission-mcp                 | MCP server for the Transmission BitTorrent client                    | Python     |
+| sabnzbd-mcp                      | MCP server for SABnzbd download management                          | Python     |
+| jellyfin-mcp                     | MCP server for Jellyfin — search, playback, metadata, admin          | Go         |
+| zotero-mcp                       | Connect Zotero research library with AI assistants                   | Python     |
+| mcp-score                        | AI-driven music score generation and MuseScore live control          | Python     |
 
 ## Usage
 
@@ -35,7 +41,7 @@ Add this flake to your inputs and apply the overlay:
     mcp-servers.url = "git+ssh://gitea@gitea.bueso.eu/luis/mcp-servers";
   };
 
-  outputs = { nixpkgs, mcp-servers, ... }: {
+  outputs = { self, nixpkgs, ... }: {
     # Apply the overlay to get packages in pkgs
     nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
       system = "x86_64-linux";
@@ -66,4 +72,4 @@ Access packages without the overlay:
 ```
 
 ## License
-Each packaged MCP server retains its original license. The Nix expressions in this repository are provided as‑is.
+Each packaged MCP server retains its original license. The Nix expressions in this repository are provided as-is.

flake.lock

@@ -1,30 +1,12 @@
 {
   "nodes": {
-    "flake-utils": {
-      "inputs": {
-        "systems": "systems"
-      },
-      "locked": {
-        "lastModified": 1731533236,
-        "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",
-        "owner": "numtide",
-        "repo": "flake-utils",
-        "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",
-        "type": "github"
-      },
-      "original": {
-        "owner": "numtide",
-        "repo": "flake-utils",
-        "type": "github"
-      }
-    },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1770181073,
+        "lastModified": 1781577229,
-        "narHash": "sha256-ksTL7P9QC1WfZasNlaAdLOzqD8x5EPyods69YBqxSfk=",
+        "narHash": "sha256-lrp67w8AulE9Ks53n27I45ADSzbOCn4H+CNW1Ck8B+8=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "bf922a59c5c9998a6584645f7d0de689512e444c",
+        "rev": "567a49d1913ce81ac6e9582e3553dd90a955875f",
         "type": "github"
       },
       "original": {
@@ -36,24 +18,8 @@
     },
     "root": {
       "inputs": {
-        "flake-utils": "flake-utils",
         "nixpkgs": "nixpkgs"
       }
-    },
-    "systems": {
-      "locked": {
-        "lastModified": 1681028828,
-        "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
-        "owner": "nix-systems",
-        "repo": "default",
-        "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
-        "type": "github"
-      },
-      "original": {
-        "owner": "nix-systems",
-        "repo": "default",
-        "type": "github"
-      }
     }
   },
   "root": "root",

flake.nix

@@ -12,52 +12,59 @@
 
   inputs = {
     nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
-    flake-utils.url = "github:numtide/flake-utils";
   };
 
   outputs =
+    { self, nixpkgs, ... }:
+    let
+      supportedSystems = [
+        "x86_64-linux"
+        "aarch64-linux"
+        "x86_64-darwin"
+        "aarch64-darwin"
+      ];
+      forAllSystems = nixpkgs.lib.genAttrs supportedSystems;
+    in
     {
-      self,
-      nixpkgs,
-      flake-utils,
-      ...
-    }:
-    {
-      # Overlay that adds all MCP packages to nixpkgs
       overlays.default = import ./overlays/default.nix;
     }
-    // flake-utils.lib.eachDefaultSystem (
+    // {
-      system:
+      packages = forAllSystems (
-      let
+        system:
-        pkgs = import nixpkgs {
+        let
-          inherit system;
+          pkgs = import nixpkgs {
-          overlays = [ self.overlays.default ];
+            inherit system;
-        };
+            overlays = [ self.overlays.default ];
-
+          };
-        # Import all MCP packages
+          mcpPackages = import ./packages { inherit pkgs; };
-        mcpPackages = import ./packages { inherit pkgs; };
+        in
-
+        mcpPackages // {
-        # List of all MCP server packages (for devShell)
-        allMcpServers = builtins.attrValues mcpPackages ++ [ pkgs.mcp-nixos ];
-      in
-      {
-        # Export all packages
-        packages = mcpPackages // {
           default = pkgs.symlinkJoin {
             name = "mcp-servers";
             paths = builtins.attrValues mcpPackages;
           };
-        };
+        }
+      );
 
-        devShells.default = pkgs.mkShell {
+      devShells = forAllSystems (
-          packages = allMcpServers ++ [
+        system:
-            pkgs.git
+        let
-          ];
+          pkgs = import nixpkgs {
+            inherit system;
+            overlays = [ self.overlays.default ];
+          };
+          mcpPackages = import ./packages { inherit pkgs; };
+        in
+        {
+          default = pkgs.mkShell {
+            packages = builtins.attrValues mcpPackages ++ [ pkgs.mcp-nixos pkgs.git ];
+            shellHook = ''
+              export SEARXNG_BASE_URL="https://search.bueso.eu"
+            '';
+          };
+        }
+      );
 
-          shellHook = ''
+      checks.x86_64-linux = builtins.removeAttrs self.packages.x86_64-linux [ "default" ];
-            export SEARXNG_BASE_URL="https://search.bueso.eu"
+    };
-          '';
-        };
-      }
-    );
 }

opencode.json

@@ -91,6 +91,11 @@
         "JELLYFIN_URL": "PLACEHOLDER",
         "JELLYFIN_API_KEY": "PLACEHOLDER"
       }
+    },
+    "mcp-score": {
+      "type": "local",
+      "command": ["mcp-score", "serve"],
+      "enabled": true
     }
   }
 }

packages/annas-mcp/package.nix

@@ -0,0 +1,36 @@
+{
+  lib,
+  buildGoModule,
+  fetchFromGitHub,
+  makeWrapper,
+}:
+
+buildGoModule rec {
+  pname = "annas-mcp";
+  version = "0.1.0-unstable-2026-06-26";
+
+  src = fetchFromGitHub {
+    owner = "iosifache";
+    repo = "annas-mcp";
+    rev = "c095963ad5d10d33da3c614495246b6ec7f680d4";
+    hash = lib.fakeHash;
+  };
+
+  vendorHash = lib.fakeHash;
+
+  nativeBuildInputs = [ makeWrapper ];
+
+  # The MCP server mode is invoked with "mcp" subcommand
+  postInstall = ''
+    wrapProgram $out/bin/annas-mcp \
+      --add-flags "mcp"
+  '';
+
+  meta = with lib; {
+    description = "MCP server and CLI tool for searching and downloading documents from Anna's Archive";
+    homepage = "https://github.com/iosifache/annas-mcp";
+    license = licenses.mit;
+    mainProgram = "annas-mcp";
+    platforms = platforms.linux;
+  };
+}

packages/applemusic-mcp/package.nix

@@ -0,0 +1,40 @@
+{
+  lib,
+  python3Packages,
+  fetchFromGitHub,
+}:
+
+python3Packages.buildPythonApplication rec {
+  pname = "applemusic-mcp";
+  version = "0.15.1";
+  pyproject = true;
+
+  src = fetchFromGitHub {
+    owner = "epheterson";
+    repo = "applemusic-mcp";
+    rev = "v${version}";
+    hash = "sha256-N97bZyT8TWOrt1WS7W31OJaICwoUxFfcDDuRs+TweTQ=";
+  };
+
+  build-system = with python3Packages; [
+    hatchling
+  ];
+
+  dependencies = with python3Packages; [
+    mcp
+    pyjwt
+    requests
+    cryptography
+    playwright
+  ];
+
+  pythonImportsCheck = [ "applemusic_mcp" ];
+
+  meta = with lib; {
+    description = "MCP server for Apple Music — manage playlists, search catalog, browse library";
+    homepage = "https://github.com/epheterson/applemusic-mcp";
+    license = licenses.mit;
+    mainProgram = "applemusic-mcp";
+    platforms = platforms.all;
+  };
+}

packages/audiobookshelf-mcp/package.nix

@@ -0,0 +1,27 @@
+{
+  lib,
+  buildGoModule,
+  fetchFromGitHub,
+}:
+
+buildGoModule rec {
+  pname = "audiobookshelf-mcp";
+  version = "unstable-2026-06-27";
+
+  src = fetchFromGitHub {
+    owner = "michaeldvinci";
+    repo = "audiobookshelf-mcp";
+    rev = "e790d9c75085772180c95f2ec1376acc98e9282c";
+    hash = "sha256-vQR+Ej3Qtg8ehIUWnXkSayNYpqnOZPWV0TpTVPYh+io=";
+  };
+
+  vendorHash = "sha256-W8hlCGf4QdFbKc3QFc9pa4MWBhnp5A5GvWFNzg0BEhw=";
+
+  meta = with lib; {
+    description = "MCP server for Audiobookshelf — libraries, audiobooks, podcasts, authors, collections, playlists";
+    homepage = "https://github.com/michaeldvinci/audiobookshelf-mcp";
+    license = licenses.gpl3Only;
+    mainProgram = "abs-mcp";
+    platforms = platforms.all;
+  };
+}

packages/default.nix

@@ -1,11 +1,3 @@
-# MCP Server Packages
-#
-# This file aggregates all MCP server packages in this repository.
-# To add a new package:
-#   1. Create a directory: packages/<package-name>/
-#   2. Create package.nix in that directory
-#   3. Add an entry below using callPackage
-#
 { pkgs }:
 
 {
@@ -16,7 +8,6 @@
   zotero-mcp = pkgs.callPackage ./zotero-mcp/package.nix { };
   pdf-reader-mcp = pkgs.callPackage ./pdf-reader-mcp/package.nix { };
   kindly-web-search-mcp-server = pkgs.callPackage ./kindly-web-search-mcp-server/package.nix { };
-  rust-research-mcp = pkgs.callPackage ./rust-research-mcp/package.nix { };
   duckduckgo-mcp-server = pkgs.callPackage ./duckduckgo-mcp-server/package.nix { };
   n8n-mcp = pkgs.callPackage ./n8n-mcp/package.nix { };
   simple-web-search-mcp = pkgs.callPackage ./simple-web-search-mcp/package.nix { };
@@ -25,5 +16,10 @@
   sabnzbd-mcp = pkgs.callPackage ./sabnzbd-mcp/package.nix { };
   jellyfin-mcp = pkgs.callPackage ./jellyfin-mcp/package.nix { };
   nextcloud-mcp-server = pkgs.callPackage ./nextcloud-mcp-server/package.nix { };
+  annas-mcp = pkgs.callPackage ./annas-mcp/package.nix { };
+  mcp-score = pkgs.callPackage ./mcp-score/package.nix { };
+  applemusic-mcp = pkgs.callPackage ./applemusic-mcp/package.nix { };
+  pinchflat-mcp = pkgs.callPackage ./pinchflat-mcp/package.nix { };
+  audiobookshelf-mcp = pkgs.callPackage ./audiobookshelf-mcp/package.nix { };
   # example-mcp-server = pkgs.callPackage ./example-mcp-server/package.nix { };
 }

packages/duckduckgo-mcp-server/package.nix

@@ -6,14 +6,14 @@
 
 python3Packages.buildPythonApplication rec {
   pname = "duckduckgo-mcp-server";
-  version = "0.1.1-unstable";
+  version = "0.4.0";
   pyproject = true;
 
   src = fetchFromGitHub {
     owner = "nickclyde";
     repo = "duckduckgo-mcp-server";
-    rev = "d198a2f0e8bd7c862d87d8517e1518aa295f8348";
+    rev = "v${version}";
-    hash = "sha256-aoWU5AVErAt73V+BgveEmVnjNh/cteS+A9AIFLylOsw=";
+    hash = "sha256-g1mpBrhuCt3g/XnUfHoY8lJDMizINypikj8Lqk2LVuE=";
   };
 
   build-system = [ python3Packages.hatchling ];

packages/jellyfin-mcp/package.nix

@@ -6,21 +6,16 @@
 
 buildGoModule rec {
   pname = "jellyfin-mcp";
-  version = "2026.318.7";
+  version = "2026.604.2";
 
   src = fetchFromGitHub {
     owner = "jaredtrent";
     repo = "jellyfin-mcp";
     tag = "v${version}";
-    hash = "sha256-/6Sy8C5+/x90ZTo74qX0agTHybsWw+Vg416GBM1PS7k=";
+    hash = "sha256-Ks54txfOAkNEWfhl5ZXEIaFzAbmCnwhHtN1+FIa7dgo=";
   };
 
-  # go.mod requires 1.25.6 but nixpkgs has 1.25.5; patch to relax
+  vendorHash = "sha256-cDy+PpZM6xL7ur/xq81y4vlyaDnSOpGkyVV2hh8qI7o=";
-  postPatch = ''
-    substituteInPlace go.mod --replace-fail "go 1.25.6" "go 1.25.5"
-  '';
-
-  vendorHash = "sha256-WYb+BpnKUUrgcJ0zChdTb1oB99R8bTgpSXUtjPKhL6M=";
 
   meta = with lib; {
     description = "MCP server for Jellyfin media server — search, playback, metadata, admin";

packages/kindly-web-search-mcp-server/package.nix

@@ -77,8 +77,8 @@ python313Packages.buildPythonApplication rec {
   src = fetchFromGitHub {
     owner = "Shelpuk-AI-Technology-Consulting";
     repo = "kindly-web-search-mcp-server";
-    rev = "2fd83d28710cce335f610e3d5ed0b403250ab1ba";
+    rev = "2b76afb37bf311facbde6750d0a0c0cbdfb8fec2";
-    hash = "sha256-sOLx87p+w51wuBOItDdzrsrgItNZ92WivZAv3Zzp16o=";
+    hash = "sha256-90QHr2FPiMSwKXmjlZ2W9NIQvj3LDXzYIq6m/Z+sJMw=";
   };
 
   build-system = with python313Packages; [
@@ -94,6 +94,7 @@ python313Packages.buildPythonApplication rec {
     nodriver
     pymupdf
     fastmcp
+    trafilatura
   ];
 
   nativeBuildInputs = [ makeWrapper ];

packages/mcp-score/package.nix

@@ -0,0 +1,76 @@
+{
+  lib,
+  python313Packages,
+  fetchFromGitHub,
+  fetchPypi,
+}:
+
+let
+  # music21 is not in nixpkgs; vendor it (upstream mcp-score pins >=9.0,<10)
+  music21 = python313Packages.buildPythonPackage rec {
+    pname = "music21";
+    version = "9.9.2";
+    format = "wheel";
+
+    src = fetchPypi {
+      inherit pname version;
+      format = "wheel";
+      dist = "py3";
+      python = "py3";
+      hash = "sha256-ZIAQq40TKNCxB0bO8UV+hLEidM0xYkgifpbSHielGMo=";
+    };
+
+    propagatedBuildInputs = with python313Packages; [
+      chardet
+      joblib
+      jsonpickle
+      matplotlib
+      more-itertools
+      numpy
+      requests
+      webcolors
+    ];
+
+    doCheck = false;
+    pythonImportsCheck = [ "music21" ];
+
+    meta = with lib; {
+      description = "Toolkit for computer-aided musicology";
+      homepage = "https://github.com/cuthbertLab/music21";
+      license = licenses.bsd3;
+    };
+  };
+in
+python313Packages.buildPythonApplication rec {
+  pname = "mcp-score";
+  version = "0.1.0-unstable";
+
+  pyproject = true;
+
+  src = fetchFromGitHub {
+    owner = "tskovlund";
+    repo = "mcp-score";
+    rev = "3ff9d4b6504fcee5032c44fdcf7dc1d7a21a4b5d";
+    hash = "sha256-zrpvzxi8AbF5/etuvMZLni4HSFBYGRe55rpKJJEAg60=";
+  };
+
+  build-system = with python313Packages; [
+    hatchling
+  ];
+
+  dependencies = with python313Packages; [
+    mcp
+    music21
+    websockets
+  ];
+
+  pythonImportsCheck = [ "mcp_score" ];
+
+  meta = with lib; {
+    description = "MCP server for AI-driven music score generation and manipulation via MusicXML and MuseScore";
+    homepage = "https://github.com/tskovlund/mcp-score";
+    license = licenses.mit;
+    mainProgram = "mcp-score";
+    platforms = platforms.all;
+  };
+}

packages/nextcloud-mcp-server/package.nix

@@ -20,6 +20,7 @@ let
       };
       inherit propagatedBuildInputs;
       doCheck = false;
+      dontCheckRuntimeDeps = true;
       inherit meta;
     };
 
@@ -131,14 +132,14 @@ let
 in
 python3Packages.buildPythonApplication rec {
   pname = "nextcloud-mcp-server";
-  version = "0.89.0";
+  version = "0.121.3";
   pyproject = true;
 
   src = fetchFromGitHub {
     owner = "cbcoutinho";
     repo = "nextcloud-mcp-server";
     rev = "v${version}";
-    hash = "sha256-IDTSGsHQ8cCFvgSO7pDbSSHVNV0OIjjoEN9ZfkaPAvk=";
+    hash = "sha256-U6BG5anTEllNnJzta4VV6QOfn86+N15q6v/SfLGM7mc=";
   };
 
   build-system = [ python3Packages.uv-build ];
@@ -152,7 +153,7 @@ python3Packages.buildPythonApplication rec {
     googleapis-common-protos opentelemetry-api opentelemetry-proto
     opentelemetry-semantic-conventions opentelemetry-sdk
     x-wr-timezone opentelemetry-util-http opentelemetry-exporter-otlp-proto-common
-    opentelemetry-instrumentation recurring-ical-events
+    opentelemetry-instrumentation recurring-ical-events icalendar-searcher
     opentelemetry-exporter-otlp-proto-grpc qdrant-client
     opentelemetry-instrumentation-asgi opentelemetry-instrumentation-httpx
     opentelemetry-instrumentation-logging langchain-text-splitters mistralai caldav
@@ -178,6 +179,12 @@ python3Packages.buildPythonApplication rec {
       --replace-quiet '">=2.4.5"' '""'
   '';
 
+  # PYTHONPATH from the host environment (e.g., mautrix bridge injecting
+  # Python 3.12 site-packages) causes C extension ABI mismatches on NixOS.
+  # The wrapper's own sys.path has the correct closure packages, so we
+  # unset the external PYTHONPATH to prevent contamination.
+  makeWrapperArgs = [ "--unset" "PYTHONPATH" ];
+
   dontCheckRuntimeDeps = true;
   catchConflicts = false;
 

packages/pinchflat-mcp/package.nix

@@ -0,0 +1,42 @@
+{
+  lib,
+  stdenv,
+  makeWrapper,
+  python3,
+}:
+
+let
+  python = python3.withPackages (
+    ps: with ps; [
+      fastmcp
+      httpx
+    ]
+  );
+in
+stdenv.mkDerivation {
+  pname = "pinchflat-mcp";
+  version = "0.1.0";
+
+  src = ./server.py;
+
+  nativeBuildInputs = [ makeWrapper ];
+
+  dontUnpack = true;
+
+  installPhase = ''
+    mkdir -p $out/lib/pinchflat-mcp $out/bin
+    cp $src $out/lib/pinchflat-mcp/server.py
+
+    makeWrapper ${python}/bin/python $out/bin/pinchflat-mcp \
+      --add-flags "$out/lib/pinchflat-mcp/server.py" \
+      --set-default PINCHFLAT_MCP_TRANSPORT stdio
+  '';
+
+  meta = with lib; {
+    description = "MCP server for Pinchflat media downloader";
+    homepage = "https://gitea.bueso.eu/hermes-agent/pinchflat";
+    license = licenses.mit;
+    mainProgram = "pinchflat-mcp";
+    platforms = platforms.all;
+  };
+}

packages/pinchflat-mcp/server.py

@@ -0,0 +1,257 @@
+#!/usr/bin/env python3
+"""Pinchflat MCP server — exposes the Pinchflat REST API as MCP tools."""
+
+import os
+import sys
+from typing import Any, Optional
+
+import httpx
+from fastmcp import FastMCP
+
+PINCHFLAT_URL = os.environ.get("PINCHFLAT_URL", "http://localhost:8945")
+PINCHFLAT_TOKEN = os.environ.get("PINCHFLAT_API_TOKEN", "")
+
+if not PINCHFLAT_TOKEN:
+    print("PINCHFLAT_API_TOKEN environment variable is required", file=sys.stderr)
+    sys.exit(1)
+
+BASE = f"{PINCHFLAT_URL.rstrip('/')}/api/v1"
+HEADERS = {"Authorization": f"Bearer {PINCHFLAT_TOKEN}", "Content-Type": "application/json"}
+
+mcp = FastMCP("pinchflat")
+
+
+def _get(path: str, params: Optional[dict] = None) -> Any:
+    """Make a GET request to the Pinchflat API."""
+    with httpx.Client(timeout=30) as client:
+        r = client.get(f"{BASE}{path}", headers=HEADERS, params=params)
+        r.raise_for_status()
+        return r.json()
+
+
+def _post(path: str, json: Optional[dict] = None) -> Any:
+    """Make a POST request to the Pinchflat API."""
+    with httpx.Client(timeout=30) as client:
+        r = client.post(f"{BASE}{path}", headers=HEADERS, json=json)
+        r.raise_for_status()
+        return r.json()
+
+
+def _put(path: str, json: dict) -> Any:
+    """Make a PUT request to the Pinchflat API."""
+    with httpx.Client(timeout=30) as client:
+        r = client.put(f"{BASE}{path}", headers=HEADERS, json=json)
+        r.raise_for_status()
+        return r.json()
+
+
+def _delete(path: str) -> Any:
+    """Make a DELETE request to the Pinchflat API."""
+    with httpx.Client(timeout=30) as client:
+        r = client.delete(f"{BASE}{path}", headers=HEADERS)
+        r.raise_for_status()
+        return r.json()
+
+
+# --- Sources ---
+
+@mcp.tool()
+def list_sources() -> dict:
+    """List all configured media sources (YouTube channels, playlists, etc.)."""
+    return _get("/sources")
+
+
+@mcp.tool()
+def get_source(source_id: int) -> dict:
+    """Get details of a specific source by ID, including its pending tasks."""
+    return _get(f"/sources/{source_id}")
+
+
+@mcp.tool()
+def create_source(
+    original_url: str,
+    media_profile_id: int,
+    collection_type: str = "channel",
+    custom_name: Optional[str] = None,
+    download_cutoff_date: Optional[str] = None,
+) -> dict:
+    """Create a new media source (e.g. add a YouTube channel to monitor).
+
+    Args:
+        original_url: URL of the channel/playlist to monitor
+        media_profile_id: ID of the media profile to use for downloads
+        collection_type: 'channel', 'playlist', or 'video'
+        custom_name: Optional custom name for the source
+        download_cutoff_date: Only download media after this date (YYYY-MM-DD)
+    """
+    source = {
+        "media_profile_id": media_profile_id,
+        "collection_type": collection_type,
+        "original_url": original_url,
+    }
+    if custom_name:
+        source["custom_name"] = custom_name
+    if download_cutoff_date:
+        source["download_cutoff_date"] = download_cutoff_date
+    return _post("/sources", json={"source": source})
+
+
+@mcp.tool()
+def update_source(
+    source_id: int,
+    custom_name: Optional[str] = None,
+    download_cutoff_date: Optional[str] = None,
+    enabled: Optional[bool] = None,
+    index_frequency_minutes: Optional[int] = None,
+) -> dict:
+    """Update an existing source. Only provided fields will be changed."""
+    updates = {}
+    if custom_name is not None:
+        updates["custom_name"] = custom_name
+    if download_cutoff_date is not None:
+        updates["download_cutoff_date"] = download_cutoff_date
+    if enabled is not None:
+        updates["enabled"] = enabled
+    if index_frequency_minutes is not None:
+        updates["index_frequency_minutes"] = index_frequency_minutes
+    return _put(f"/sources/{source_id}", json={"source": updates})
+
+
+@mcp.tool()
+def delete_source(source_id: int) -> dict:
+    """Delete a source (marks it for deletion)."""
+    return _delete(f"/sources/{source_id}")
+
+
+@mcp.tool()
+def force_download_pending(source_id: int) -> dict:
+    """Force download of all pending media items for a source."""
+    return _post(f"/sources/{source_id}/force_download_pending")
+
+
+@mcp.tool()
+def force_redownload(source_id: int) -> dict:
+    """Force re-download of all existing media for a source."""
+    return _post(f"/sources/{source_id}/force_redownload")
+
+
+@mcp.tool()
+def force_index(source_id: int) -> dict:
+    """Force re-index of a source."""
+    return _post(f"/sources/{source_id}/force_index")
+
+
+@mcp.tool()
+def force_metadata_refresh(source_id: int) -> dict:
+    """Force metadata refresh for a source."""
+    return _post(f"/sources/{source_id}/force_metadata_refresh")
+
+
+# --- Media Items ---
+
+@mcp.tool()
+def list_media(
+    source_id: Optional[int] = None,
+    limit: int = 50,
+    offset: int = 0,
+    downloaded: Optional[bool] = None,
+) -> dict:
+    """List media items with pagination. Optionally filter by source_id or download status.
+
+    Args:
+        source_id: Filter to a specific source
+        limit: Max items to return (default 50)
+        offset: Skip first N items for pagination (default 0)
+        downloaded: If True, only return downloaded media; if False, only undownloaded
+    """
+    params = {"limit": limit, "offset": offset}
+    if source_id:
+        params["source_id"] = source_id
+    if downloaded is not None:
+        params["downloaded"] = "true" if downloaded else "false"
+    return _get("/media", params=params)
+
+
+@mcp.tool()
+def search_media(query: str) -> dict:
+    """Search media items by title or description."""
+    return _get("/media/search", params={"q": query})
+
+
+@mcp.tool()
+def get_media(media_id: int) -> dict:
+    """Get details of a specific media item."""
+    return _get(f"/media/{media_id}")
+
+
+@mcp.tool()
+def force_download_media(media_id: int) -> dict:
+    """Force download of a specific media item."""
+    return _post(f"/media/{media_id}/force_download")
+
+
+@mcp.tool()
+def delete_media(media_id: int, prevent_download: bool = False) -> dict:
+    """Delete a media item's downloaded files from disk.
+
+    Args:
+        media_id: The media item ID to delete
+        prevent_download: If True, prevent the item from being re-downloaded in the future
+    """
+    params = {}
+    if prevent_download:
+        params["prevent_download"] = "true"
+    with httpx.Client(timeout=120) as client:
+        r = client.delete(f"{BASE}/media/{media_id}", headers=HEADERS, params=params)
+        r.raise_for_status()
+        return r.json()
+
+
+# --- Media Profiles ---
+
+@mcp.tool()
+def list_media_profiles() -> dict:
+    """List all media profiles (download quality/container settings)."""
+    return _get("/media_profiles")
+
+
+@mcp.tool()
+def get_media_profile(profile_id: int) -> dict:
+    """Get details of a specific media profile."""
+    return _get(f"/media_profiles/{profile_id}")
+
+
+# --- Tasks ---
+
+@mcp.tool()
+def list_tasks(source_id: Optional[int] = None) -> dict:
+    """List all tasks. Optionally filter by source_id."""
+    params = {}
+    if source_id:
+        params["source_id"] = source_id
+    return _get("/tasks", params=params)
+
+
+@mcp.tool()
+def get_task(task_id: int) -> dict:
+    """Get details of a specific task."""
+    return _get(f"/tasks/{task_id}")
+
+
+# --- Settings & Info ---
+
+@mcp.tool()
+def get_settings() -> dict:
+    """Get current Pinchflat settings."""
+    return _get("/settings")
+
+
+@mcp.tool()
+def get_app_info() -> dict:
+    """Get Pinchflat app info (version, environment, etc.)."""
+    return _get("/app_info")
+
+
+if __name__ == "__main__":
+    transport = os.environ.get("PINCHFLAT_MCP_TRANSPORT", "stdio")
+    mcp.run(transport=transport if transport in ("stdio", "http") else "stdio")

packages/rust-research-mcp/package.nix

@@ -1,50 +0,0 @@
-{
-  lib,
-  rustPlatform,
-  fetchFromGitHub,
-  pkg-config,
-  openssl,
-}:
-
-rustPlatform.buildRustPackage rec {
-  pname = "rust-research-mcp";
-  version = "0.6.7-unstable";
-
-  src = fetchFromGitHub {
-    owner = "Ladvien";
-    repo = "research_hub_mcp";
-    rev = "3335c118da9e7a9e9e7f2e608989fbe35557f3c5";
-    hash = "sha256-KkIVeFQ8hEL82ZtC+Tie+8T/eZcEoWyq5cRVgdinQEc=";
-  };
-
-  cargoHash = "sha256-zwhQ2ksFbedeuzTaJI+9t9of6es7RJa6JwRHQRznqBY=";
-
-  nativeBuildInputs = [
-    pkg-config
-  ];
-
-  buildInputs = [
-    openssl
-  ];
-
-  doCheck = false;
-
-  # The build.rs uses vergen to embed git info, which fails without a git repo.
-  # Set environment variables to satisfy vergen during build.
-  env = {
-    VERGEN_GIT_BRANCH = "main";
-    VERGEN_GIT_COMMIT_DATE = "2025-09-25";
-    VERGEN_GIT_COMMIT_TIMESTAMP = "2025-09-25T19:35:10Z";
-    VERGEN_GIT_SHA = "3335c118da9e7a9e9e7f2e608989fbe35557f3c5";
-    VERGEN_BUILD_DATE = "2025-09-25";
-    VERGEN_BUILD_TIMESTAMP = "2025-09-25T19:35:10Z";
-  };
-
-  meta = with lib; {
-    description = "MCP server for accumulating and organizing academic knowledge";
-    homepage = "https://github.com/Ladvien/research_hub_mcp";
-    license = licenses.gpl3Only;
-    mainProgram = pname;
-    platforms = platforms.all;
-  };
-}

packages/sabnzbd-mcp/package.nix

@@ -23,7 +23,7 @@ stdenv.mkDerivation {
   src = fetchFromGitHub {
     owner = "jmagar";
     repo = "sabnzbd-mcp";
-    rev = "refs/heads/main";
+    rev = "9d691ed70b72397fddec03ca4ec68c81b30c79c3";
     hash = "sha256-1sEnHH40cDVT5oiZD2Xywl7S9vJThii/ce+6r+XmpSw=";
   };
 

packages/zotero-mcp/package.nix

@@ -39,14 +39,14 @@ let
 in
 python3Packages.buildPythonApplication rec {
   pname = "zotero-mcp";
-  version = "0.2.2";
+  version = "0.5.0";
   pyproject = true;
 
   src = fetchFromGitHub {
     owner = "54yyyu";
     repo = "zotero-mcp";
     rev = "v${version}";
-    hash = "sha256-GZkzABsUh6qua66K4URPq0InLgs6cqLgKEXm7wzT+s8=";
+    hash = "sha256-ioy6bdP+jFioUGBKiiYtD4nbdFe6v2E3nCi6s9+dTT0=";
   };
 
   build-system = with python3Packages; [
@@ -67,6 +67,12 @@ python3Packages.buildPythonApplication rec {
     pymupdf
     ebooklib
     pdfplumber
+    # Semantic search
+    chromadb
+    sentence-transformers
+    openai
+    google-genai
+    tiktoken
   ];
 
   # Optional: semantic search dependencies