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

.gitignore

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

packages/annas-mcp/package.nix

@@ -2,28 +2,35 @@
   lib,
   buildGoModule,
   fetchFromGitHub,
+  makeWrapper,
 }:
 
 buildGoModule rec {
   pname = "annas-mcp";
-  version = "0.0.5";
+  version = "0.1.0-unstable-2026-06-26";
 
   src = fetchFromGitHub {
     owner = "iosifache";
     repo = "annas-mcp";
-    rev = "v${version}";
-    hash = "sha256-XicM7tU5jD8B8n7JJDQ/84koBiLb8XF4+WBQ4LCUoRU=";
+    rev = "c095963ad5d10d33da3c614495246b6ec7f680d4";
+    hash = lib.fakeHash;
   };
 
-  vendorHash = "sha256-2NdG5p2XfrhVgi388dRDBUSGwg6ybnzfn9495TWNGsA=";
+  vendorHash = lib.fakeHash;
 
-  subPackages = [ "cmd/annas-mcp" ];
+  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 for searching and downloading documents from Anna's Archive";
+    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.all;
+    platforms = platforms.linux;
   };
 }

packages/audiobookshelf-mcp/package.nix

@@ -12,10 +12,10 @@ buildGoModule rec {
     owner = "michaeldvinci";
     repo = "audiobookshelf-mcp";
     rev = "e790d9c75085772180c95f2ec1376acc98e9282c";
-    hash = lib.fakeHash;
+    hash = "sha256-vQR+Ej3Qtg8ehIUWnXkSayNYpqnOZPWV0TpTVPYh+io=";
   };
 
-  vendorHash = lib.fakeHash;
+  vendorHash = "sha256-W8hlCGf4QdFbKc3QFc9pa4MWBhnp5A5GvWFNzg0BEhw=";
 
   meta = with lib; {
     description = "MCP server for Audiobookshelf — libraries, audiobooks, podcasts, authors, collections, playlists";

packages/pinchflat-mcp/server.py

@@ -150,11 +150,25 @@ def force_metadata_refresh(source_id: int) -> dict:
 # --- Media Items ---
 
 @mcp.tool()
-def list_media(source_id: Optional[int] = None, limit: int = 50) -> dict:
-    """List media items. Optionally filter by source_id."""
-    params = {}
+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)
 
 
@@ -176,6 +190,23 @@ def force_download_media(media_id: int) -> dict:
     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()