RagMCP Server

RagMCP is a local command-based server that accepts JSON-style commands to perform actions such as opening websites, playing YouTube songs, controlling system tools, and performing web searches. You use a client to send commands, and RagMCP executes the requested actions on your machine. This makes it easy to automate everyday tasks from a single interface.

How to use

You interact with RagMCP by sending structured commands from a client. Each command specifies which action you want to perform and the parameters it needs. You can trigger playback of YouTube content, open web pages, perform web searches on supported sites, and run system actions like creating folders, changing the wallpaper, or shutting down the PC. Use the client’s interface to issue a command that targets the desired tool, and RagMCP will carry out the action on your device.

Typical usage patterns include directing RagMCP to play a specific YouTube song, open a search result on a chosen site, or perform a system task like creating a folder. Plan your commands by identifying the tool you want to use and the required parameters, then execute the request through your MCP client. RagMCP will handle browser automation, page navigation, and system interactions as needed, returning results or status updates to your client.

How to install

# Prerequisites
python3 --version
# Create a virtual environment
python -m venv .venv

# Activate the virtual environment
# Windows PowerShell
.\.venv\Scripts\Activate

# Install required packages
pip install -r requirements.txt
# If requirements.txt is missing, install core deps manually
pip install playwright pyautogui
pip install psutil

# Set up Playwright browsers
playwright install

# Run the RagMCP server
ragmcp
# If the above fails, try running via Python directly
python -m ragmcp

Additional setup and notes

The server is designed to work with Chrome-based browsers for stability and reliability. When you install dependencies, make sure your Python environment is active so the server can locate all required packages. If you modify any core logic, ensure you understand the impact on command handling and browser automation.

Configuration and startup

Start the server using either of these runtime options. Choose the method that matches how you installed RagMCP on your system.

ragmcp

python -m ragmcp

Tools and capabilities overview

RagMCP exposes a set of tools you can invoke through your MCP client. These tools include YouTube playback, web search, and core system utilities. Each tool is designed to be invoked with a clear name and a minimal set of parameters to perform its task.

Troubleshooting and tips

If you encounter issues starting the server, ensure you are running commands from the project directory where the server code resides and that your Python environment is activated. Check that Playwright has been installed and that its browsers are installed as well. If the server reports missing dependencies, reinstall the required packages and re-run the browser setup.

Available tools

open_website

Opens a specified website by name or URL so you can browse content without leaving the command interface.

play_youtube_direct

Plays a YouTube track or video based on a direct query, starting playback in your chosen browser.

play_trending_music

Launches playback of trending music from YouTube to quickly hear popular tracks.

play_youtube_from_favourites

Plays a track from your favourites collection, identified by a named entry.

play_youtube_mood

Selects music to match a given mood and starts playback.

search_fitgirl

Searches FitGirl-related content based on a query.

search_pinterest

Searches Pinterest for images or boards matching a query.

search_google

Performs a Google search for a given query.

shutdown_pc

Initiates a system shutdown sequence on the local machine.

create_folder

Creates a new folder at the specified path.

set_wallpaper

Sets the desktop wallpaper from a specified image path.