search_redditLABSCO SUMMARY
The hardened image is a one-line swap.
Two images ship: latest runs as root in a single build stage, and hardened runs as a non-root user from a multi-stage build and expects --cap-drop=ALL and --security-opt no-new-privileges:true. Same tools either way. Since the whole point of routing through Redlib is to keep the reading private, taking the hardened tag costs you nothing but a longer run command.
What it is
A Reddit reader that goes through Redlib, the self-hosted privacy front end, instead of Reddit's API. It returns clean JSON rather than scraped HTML, and there is no Reddit account or key anywhere in the path.
What you get
search_reddittakes a query and an optional subreddit, and returns post ids, titles, authors, scores and comment countsget_subreddit_hotreturns hot posts for one subreddit, with an optional limit that defaults to 25get_posttakes a subreddit and a post id and returns the full body, the score, and up to 10 top comments
Requirements
A running Redlib instance — REDLIB_URL defaults to http://localhost:8080 and is the only setting there is. The package is redlib-mcp-server, version 1.0.0. Easiest path is the published image alfafadock/mcp-redlib:latest, run with -i --rm --network host and the URL passed through -e; or build from source with npm install and npm run build. Transport is stdio only, so the server runs on the same machine as the client and exposes no HTTP port.
Setup effort
One command — docker run -i --rm --network host -e REDLIB_URL=http://localhost:8080 alfafadock/mcp-redlib:latest
USE CASES
01
Researching what a community actually says about something
Search across Reddit or inside one subreddit and get structured results back, not a page of markup.
02
Reading a thread and its discussion
Pull the full post plus its top comments, so the answer reflects the replies and not just the title.
03
Catching up on a subreddit
Get the current hot posts for one community, capped to as many as you want.
3 tools
Listed in project docs. Your client may show a different list.
get_subreddit_hotget_postBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Where it runs
All 6 documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
Build from source
TERMINAL
# Clone and setup
git clone https://github.com/Devthatdoes/redlib-mcp-server.git
cd redlib-mcp-server
# Install dependencies
npm install
# Build
npm run build
# Run
npm startdocker
TERMINAL
docker run -i --rm \
--network host \
-e REDLIB_URL=http://localhost:8080 \
alfafadock/mcp-redlib:latestMCP Clients
Claude Desktop, Cursor, Other MCP clients
JSON
{
"mcpServers": {
"redlib": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--network",
"host",
"-e",
"REDLIB_URL=http://localhost:8080",
"alfafadock/mcp-redlib:latest"
]
}
}
}VS Code — workspace, global
JSON
{
"servers": {
"redlib": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--network",
"host",
"-e",
"REDLIB_URL=http://localhost:8080",
"alfafadock/mcp-redlib:latest"
]
}
}
}Codex
CODEX · TOML
[mcp_servers.redlib]
command = "docker"
args = ["run", "-i", "--rm", "--network", "host", "-e", "REDLIB_URL=http://localhost:8080", "alfafadock/mcp-redlib:latest"]
