Advertise
MCP.so
Sign In

MCP File Reader Server

@spar65

Repository

Basic information

Category

Other

Transports

stdio

Author

spar65

About MCP File Reader Server

No overview available yet

MCP File Reader Server config

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

{
  "mcpServers": {
    "file-reader": {
      "command": "/FULL/PATH/TO/YOUR/PROJECT/venv/bin/python",
      "args": [
        "/FULL/PATH/TO/YOUR/PROJECT/mcp-file-reader-example/file_reader_server.py"
      ],
      "enabled": true,
      "env": {}
    }
  }
}

MCP File Reader Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Overview

What is MCP File Reader Server?

A simple MCP server that reads files from a designated data directory. It supports two transport modes: Stdio (managed by Cursor) and SSE (run manually via Uvicorn/Starlette). Designed for developers who want to make local file content accessible to AI assistants within Cursor.

How to use MCP File Reader Server?

Install Python 3.8+, clone the repo, create a virtual environment, and install dependencies (mcp, uvicorn[standard], starlette, httpx). For Stdio mode, configure the global Cursor MCP config file to point to the server script and toggle it on in Cursor Settings. For SSE mode, run ./start_sse.sh and let Cursor discover the server via the project’s .mcp.json file. Then issue prompts like read test.txt using the file-reader server (Stdio) or read sse_test.txt using the file-reader-sse server (SSE).

Key features of MCP File Reader Server

  • Two transport modes: Stdio (Cursor-managed) and SSE (manual Uvicorn)
  • Reads files from a dedicated data directory per mode
  • Includes an SSE client script for manual testing
  • Logging output to stderr for troubleshooting
  • MIT licensed

Use cases of MCP File Reader Server

  • Let an AI assistant read configuration or log files from a local data folder
  • Provide file content as context during coding sessions in Cursor
  • Test MCP server interactions using the included SSE client script
  • Securely expose a limited directory of text files to an MCP client

Frequently asked questions

1

Which data directory does each mode use?

Stdio mode (`file-reader`) reads from `~/mcp_data` (home directory). SSE mode (`file-reader-sse`) reads from `./project_mcp_data_sse` (within the project directory).

2

How do I run the SSE server?

Run `./start_sse.sh` in the project root. It installs dependencies and starts a Uvicorn server listening on `http://127.0.0.1:8080`. The client connects to the `/sse` path.

3

What dependencies are required?

Python 3.8+, the `mcp` package, and for SSE mode additionally `uvicorn[standard]`, `starlette`, and `httpx`.

4

Can I toggle the server in Cursor’s UI?

Yes, for Stdio mode you must first configure the global `cursor_mcp_config.json`, then restart Cursor and toggle `file-reader` on in Cursor Settings → MCP.

5

What transport does each mode use?

Stdio mode runs the server as a subprocess managed by Cursor. SSE mode runs an HTTP server that listens for SSE connections; the client connects via `sse_client`.

Comments

More Other MCP servers

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K
Advertise