# 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.