Skip to main content
Glama

βœ… RagMCP Project Manual (Developer Guide)


πŸ”₯ 1. Project Overview

RagMCP is a local command-based assistant that:

βœ… Opens websites βœ… Plays YouTube songs using Playwright βœ… Controls system tools (create folder, set wallpaper, shutdown PC) βœ… Searches websites like FitGirl, Pinterest, etc.

It works using a server (ragmcp) that listens to JSON commands and performs actions.


πŸ“₯ 2. Download the Project

Option 1: Clone GitHub Repo

git clone https://github.com/yourusername/RagMCP.git
cd RagMCP

Option 2: Download Zip

  1. Click Download Zip

  2. Extract to D:\MINI PROJECTS\RAGMCP


🧰 3. Setup Python Environment

3.1 Create Virtual Environment

python -m venv .venv

3.2 Activate Virtual Environment

Windows PowerShell

.\.venv\Scripts\Activate

πŸ“¦ 4. Install Required Packages

Run:

pip install -r requirements.txt

If requirements.txt not exist, install manually:

pip install playwright pyautogui
pip install psutil

⚠️ Playwright Browser Setup

playwright install

πŸš€ 5. Run the Server

Start RagMCP Server

ragmcp

If command not found:

python -m ragmcp

🧩 6. How to Use RagMCP (JSON Commands)

Example format:

{"id": 1, "method": "METHOD_NAME", "params": {"param": "value"}}

🎯 7. YouTube Tool Commands

Case 1: Play Specific Song

{"id": 1, "method": "play_youtube_direct", "params": {"query": "Naa Ready song"}}
{"id": 1, "method": "play_trending_music", "params": {}}

Case 3: Play Favourite Song

{"id": 1, "method": "play_youtube_from_favourites", "params": {"favourite": "A.R. Rahman"}}

Mood Based Music

{"id": 1, "method": "play_youtube_mood", "params": {"mood": "happy"}}

🌐 8. Web Tools Commands

Open any website

{"id": 1, "method": "open_website", "params": {"site": "google"}}

Search on Google

{"id": 1, "method": "search_google", "params": {"query": "Thalapathy aesthetic"}}

Search on FitGirl

{"id": 1, "method": "search_fitgirl", "params": {"query": "Batman Arkham City"}}

Search on Pinterest

{"id": 1, "method": "search_pinterest", "params": {"query": "Thalapathy aesthetics"}}

πŸ–₯️ 9. System Tools Commands

Create Folder

{"id": 1, "method": "create_folder", "params": {"path": "C:\\Users\\User\\Desktop\\afrah"}}

Set Wallpaper

{"id": 1, "method": "set_wallpaper", "params": {"path": "D:\\wallpapers\\image.jpg"}}

Shutdown PC

{"id": 1, "method": "shutdown_pc", "params": {}}

🧠 10. Important Notes

βœ”οΈ Always run ragmcp server first βœ”οΈ Use Chrome-based browsers for best stability βœ”οΈ Playwright opens browser automatically and waits until user closes it βœ”οΈ Do not change logic without understanding it


🏁 Project Finalization

Once you run all tools and verify functionality:

βœ… Save project βœ… Commit to GitHub βœ… Share with developer


Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Notion AI to interact with local files, execute shell commands, and delegate complex tasks to local AI agents. Provides file operations, command execution, and task delegation capabilities for local workspace management.
      116
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to control Windows systems through natural language commands, providing 200+ automation tools for system control, file operations, web automation, and more.
      62
      MIT