PDF Search For Zed MCP Server

An MCP server extension for Zed that retrieves relevant pieces from a PDF file

Local serverstdioPython

What is the PDF Search For Zed MCP server?

If you already use PDF Search For Zed, the pdf search for zed mcp server is the piece that lets your assistant work with it directly. An MCP server extension for Zed that retrieves relevant pieces from a PDF file.

What the server does

A document search extension for Zed that lets you semantically search through a PDF document and use the results in Zed's AI Assistant.

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client.

Credentials and setup notes

Configuration is passed through the environment: OPENAI_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

This extension currently requires: 1. An OpenAI API key (to generate embeddings) 2. uv installed on your system Note: While the current setup requires an OpenAI API key for generating embeddings, we plan to implement a self-contained alternative in future versions. Community feedback will help prioritize these improvements.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. It is maintained by freespirit; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Configuration

This extension currently requires: 1. An OpenAI API key (to generate embeddings) 2. uv installed on your system Note: While the current setup requires an OpenAI API key for generating embeddings, we plan to implement a self-contained alternative in future versions. Community feedback will help prioritize these improvements.

VariableDescriptionRequired
OPENAI_API_KEYCredential the server authenticates with.Yes

Frequently asked questions

You need an OpenAI API key to generate embeddings and `uv` installed on your system. The extension also requires cloning the repository and manually building the search index.