Redlib MCP Server

AModel Context Protocol (MCP) serverthat enables AI agents to interact with Reddit through your privateRedlibinstance. No Reddit API keys required - just a running Redlib instance!

https://github.com/user-attachments/assets/66eec084-e911-4eed-a51f-be303e86f1a7

- Features
- Current Implementation
- Prerequisites
- Quick Start
- Configuration
- Available Tools
- Integration with AI Clients

- Claude Desktop
- Cursor
- VS Code / GitHub Copilot
- OpenAI Codex
- ForgeCode
- KiloCode

- Claude Desktop
- Cursor
- VS Codewith GitHub Copilot
- OpenAI Codex
- ForgeCode
- KiloCode

# Pull and run the default version docker run -i --rm \ --network host \ -e REDLIB_URL=http://localhost:8080 \ alfafadock/mcp-redlib:latest

# Uses non-root user and minimal privileges docker run -i --rm \ --network host \ --cap-drop=ALL \ --security-opt no-new-privileges:true \ -e REDLIB_URL=http://localhost:8080 \ alfafadock/mcp-redlib:hardened

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

services: redlib-mcp: image: alfafadock/mcp-redlib:latest container_name: redlib-mcp network_mode: "host" # Uses host network for MCP client communication environment: - REDLIB_URL=http://localhost:8080 # Change if Redlib is on a different port restart: unless-stopped # For hardened image, change image to: alfafadock/mcp-redlib:hardened

docker run -i --rm \ --network host \ -e REDLIB_URL=http://localhost:8085 \ alfafadock/mcp-redlib:latest

{ "query": "rust programming", "subreddit": "rust" }

{ "subreddit": "rust", "limit": 10 }

{ "subreddit": "rust", "postId": "abc123" }

{ "mcpServers": { "redlib": { "command": "docker", "args": [ "run", "-i", "--rm", "--network", "host", "-e", "REDLIB_URL=http://localhost:8080", "alfafadock/mcp-redlib:latest" ] } } }

{ "mcpServers": { "redlib": { "command": "docker", "args": [ "run", "-i", "--rm", "--network", "host", "-e", "REDLIB_URL=http://localhost:8085", "alfafadock/mcp-redlib:latest" ] } } }

After updating:Restart Claude Desktop. You should see a hammer icon (🔨) indicating MCP tools are available.

Add to~/.cursor/mcp.json(global) or.cursor/mcp.json(project level):

{ "mcpServers": { "redlib": { "command": "docker", "args": ["run", "-i", "--rm", "--network", "host", "-e", "REDLIB_URL=http://localhost:8080", "alfafadock/mcp-redlib:latest"] } } }

Project-level setup:Create.cursor/mcp.jsonin your project root.

After updating:Cursor will automatically detect the changes. Use the Command Palette (Cmd/Ctrl+Shift+P) and search for "MCP" to manage servers.

Create.vscode/mcp.jsonin your project:

{ "servers": { "redlib": { "command": "docker", "args": ["run", "-i", "--rm", "--network", "host", "-e", "REDLIB_URL=http://localhost:8080", "alfafadock/mcp-redlib:latest"] } } }

Use Command Palette (Cmd/Ctrl+Shift+P) → "MCP: Open User Configuration":

{ "mcp": { "servers": { "redlib": { "command": "docker", "args": ["run", "-i", "--rm", "--network", "host", "-e", "REDLIB_URL=http://localhost:8080", "alfafadock/mcp-redlib:latest"] } } } }

After updating:Reload VS Code. The tools will appear in GitHub Copilot's Agent Mode.

Edit~/.codex/config.toml(global) or.codex/config.toml(project):

[mcp_servers.redlib] command = "docker" args = ["run", "-i", "--rm", "--network", "host", "-e", "REDLIB_URL=http://localhost:8080", "alfafadock/mcp-redlib:latest"]

Project-level setup:Create.codex/config.tomlin your project root.

After updating:Restart Codex. Usecodex mcp listto verify the server is loaded.

ForgeCode supports MCP servers via theforge mcpcommand for easy import.

Use the built-in MCP import functionality:

# Import the Redlib MCP server forge mcp import alfafadock/mcp-redlib:latest # List imported servers forge mcp list # Reload to apply changes forge mcp reload

{ "mcpServers": { "redlib": { "command": "docker", "args": ["run", "-i", "--rm", "--network", "host", "-e", "REDLIB_URL=http://localhost:8080", "alfafadock/mcp-redlib:latest"] } } }

Edit ForgeCode's config directory (check extension settings for the exact path).

After updating:Reload the ForgeCode extension usingforge mcp reload. The MCP tools should appear in the AI assistant interface.

Edit~/.config/kilo/kilo.jsoncor use Settings → MCP in KiloCode:

{ "mcpServers": { "redlib": { "command": "docker", "args": ["run", "-i", "--rm", "--network", "host", "-e", "REDLIB_URL=http://localhost:8080", "alfafadock/mcp-redlib:latest"] } } }

Create.kilocode/mcp.jsonorkilo.jsoncin your project root:

{ "mcpServers": { "redlib": { "command": "docker", "args": ["run", "-i", "--rm", "--network", "host", "-e", "REDLIB_URL=http://localhost:8080", "alfafadock/mcp-redlib:latest"] } } }

After updating:Open KiloCode Settings → MCP → Add Server, or edit the config file directly.

docker run -i --rm \ --cap-drop=ALL \ --security-opt no-new-privileges:true \ --network host \ -e REDLIB_URL=http://localhost:8080 \ alfafadock/mcp-redlib:hardened

redlib-mcp-server/ ├── src/ │ └── index.ts # Main server code (stdio transport) ├── dist/ # Compiled JavaScript (gitignored) ├── Dockerfile # Default Docker image ├── Dockerfile.hardened # Hardened Docker image ├── docker-compose.yml # Production compose ├── package.json ├── tsconfig.json └── README.md

# Install dependencies npm install # Build TypeScript npm run build # Run locally npm start

# Default version docker build -t redlib-mcp-server . # Hardened version docker build -f Dockerfile.hardened -t redlib-mcp-server:hardened .

Once connected to your AI client (e.g., Claude), you can:

User: "Search Reddit for 'home lab setup' and summarize the top results" AI uses search_reddit tool → Returns structured JSON with posts → AI summarizes the findings for you

User: "Get the full post and comments for that Rust tutorial I searched earlier" AI uses get_post with postId → Returns post body + comments → AI provides detailed analysis

- Fork the repository
- Create a feature branch
- Submit a pull request

MIT License - feel free to use this project however you want!

- Redlib- The private Reddit front-end this server interfaces with
- Model Context Protocol- The protocol that makes this integration possible
- Cheerio- HTML parsing library used to extract structured data

- Docker Hub:alfafadock/mcp-redlib
- Issues:GitHub Issues
- Redlib:github.com/redlib-org/redlib

MCP server for Al Jazeera 360 — Connect AI assistants to Al Jazeera's streaming catalog. Search, browse, and retrieve Arabic video content with direct watch links.