docs

README.md

@@ -0,0 +1,60 @@
+# MCP Server Packages for Nix
+
+## Overview
+
+This repository provides Nix derivations for MCP (Model Context Protocol) servers that are not yet available in nixpkgs.
+
+## Available Packages
+
+| Package                    | Description                                              | Language   |
+|----------------------------|----------------------------------------------------------|------------|
+| academic-search-mcp-server | Search academic papers via Semantic Scholar and Crossref | Python     |
+| manim-mcp-server           | Execute Manim animation code and return videos           | Python     |
+| pdf-reader-mcp             | Production‑ready PDF processing with parallel processing | TypeScript |
+| zotero-mcp                 | Connect Zotero research library with AI assistants       | Python     |
+
+## Usage
+
+### Using the Overlay (Recommended)
+
+Add this flake to your inputs and apply the overlay:
+
+```nix
+{
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+    mcp.url = "github:YOUR-USERNAME/mcp";  # Update with your repo
+  };
+
+  outputs = { nixpkgs, mcp, ... }: {
+    # Apply the overlay to get packages in pkgs
+    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
+      system = "x86_64-linux";
+      modules = [
+        {
+          nixpkgs.overlays = [ mcp.overlays.default ];
+        }
+        # Now you can use pkgs.manim-mcp-server
+      ];
+    };
+  };
+}
+```
+
+### Using Packages Directly
+
+Access packages without the overlay:
+
+```nix
+{
+  inputs.mcp.url = "github:YOUR-USERNAME/mcp";
+
+  outputs = { mcp, ... }: {
+    # Access directly
+    myPackage = mcp.packages.x86_64-linux.manim-mcp-server;
+  };
+}
+```
+
+## License
+Each packaged MCP server retains its original license. The Nix expressions in this repository are provided as‑is.