MCP Server -- Read Papers in the local Specified Directory

@sirix-v

About MCP Server -- Read Papers in the local Specified Directory

一个阅读本地pdf格式论文的mcp服务器

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "pdf-mcp-server": {
      "url": "http://127.0.0.1:8080/sse"
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server -- Read Papers in the local Specified Directory?

It is an MCP server that exposes PDF files stored in a user-specified local directory through MCP tools. It is built in Go and designed to be used with MCP-compatible clients such as Cursor, allowing them to list and read papers from a given folder.

How to use MCP Server -- Read Papers in the local Specified Directory?

Compile the source code with go build -o pdf-mcp-server main.go, then add the binary’s path to your environment variable (e.g., on macOS, update PATH in .zshrc). Start the server with pdf-mcp-server -pdfdir=your_paper_directory (e.g., -pdfdir=/Users/sirix/lunwen). In Cursor, configure the MCP server with URL http://127.0.0.1:8080/sse and set Cursor rules to call the find_pdf and read_pdf tools.

Key features of MCP Server -- Read Papers in the local Specified Directory

Compiled from Go source code to a single binary.
Serves PDF files from a local directory specified via -pdfdir.
Provides MCP tools find_pdf and read_pdf.
Communicates over HTTP SSE at http://127.0.0.1:8080/sse.
Easy integration with Cursor’s MCP server settings.

Use cases of MCP Server -- Read Papers in the local Specified Directory

Listing all papers in a local PDF directory.
Searching for papers by file name within the specified directory.
Reading the content of a specific PDF via an MCP client.
Integrating local paper management into AI-assisted coding workflows (e.g., Cursor).
Automating paper retrieval for research or note-taking tasks.

FAQ from MCP Server -- Read Papers in the local Specified Directory

What dependencies are required to run this server?

The README only provides Go compilation instructions; the server is distributed as a compiled binary. It does not list runtime dependencies beyond the binary itself.

What transport protocol does the server use?

It serves over HTTP using Server-Sent Events (SSE) at http://127.0.0.1:8080/sse.

Where does the data (PDF files) reside?

All PDF files must be stored in the local directory specified by the -pdfdir command-line flag when starting the server.

What MCP tools are available?

The server exposes two tools: find_pdf (to list papers in the directory) and read_pdf (to read the content of a paper). The exact signatures are not detailed in the README.

Is authentication or authorization required?

No authentication or authorization is mentioned in the README; the server appears to run locally with no security measures described.

Frequently asked questions

What dependencies are required to run this server?

The README only provides Go compilation instructions; the server is distributed as a compiled binary. It does not list runtime dependencies beyond the binary itself.

What transport protocol does the server use?

It serves over HTTP using Server-Sent Events (SSE) at `http://127.0.0.1:8080/sse`.

Where does the data (PDF files) reside?

All PDF files must be stored in the local directory specified by the `-pdfdir` command-line flag when starting the server.

What MCP tools are available?

The server exposes two tools: `find_pdf` (to list papers in the directory) and `read_pdf` (to read the content of a paper). The exact signatures are not detailed in the README.