Prysm MCP Server

# 🔍 Using Prysm MCP Server with Roo Code This guide explains how to integrate the Prysm MCP Server with Roo Code to enable powerful web scraping capabilities for AI assistants. ## ✨ Installation 1. First, make sure you have the Prysm MCP Server installed: ```bash # Recommended: Install the LLM-optimized version npm install -g @pinkpixel/prysm-mcp # Or install without global installation # You can use npx directly as shown in the configuration examples ``` 2. Configure Roo Code to use the Prysm MCP Server by adding it to your MCP server configuration. ## 🛠️ Configuration Options ### Basic Configuration To add the Prysm MCP Server to Roo Code, create or edit your MCP configuration file: ```json { "mcpServers": { "prysm-scraper": { "command": "npx", "args": [ "-y", "@pinkpixel/prysm-mcp" ] } } } ``` ### Advanced Configuration Here's a more comprehensive configuration with multiple options: ```json { "mcpServers": { "prysm-scraper-basic": { "description": "Basic web scraper with default settings", "command": "npx", "args": [ "-y", "@pinkpixel/prysm-mcp" ] }, "prysm-scraper-with-output": { "description": "Web scraper with custom output directory", "command": "sh", "args": [ "-c", "PRYSM_OUTPUT_DIR=\"$HOME/roo-scrape-results\" npx -y @pinkpixel/prysm-mcp" ] }, "prysm-local-dev": { "description": "For local development with cloned repo", "command": "node", "args": [ "./dist/index.js" ], "cwd": "/path/to/local/prysm-mcp" } } } ``` ### Custom Configuration You can create a custom configuration file for the Prysm MCP Server with Roo Code. Create a JSON file with the following content: ```json { "mcpServers": { "prysm-scraper": { "command": "npx", "args": ["-y", "@pinkpixel/prysm-mcp"], "env": { "PRYSM_OUTPUT_DIR": "$HOME/roo-scrape-results", "PRYSM_IMAGE_OUTPUT_DIR": "$HOME/roo-scrape-results/images" } } } } ``` For a more complex setup with multiple configurations: ```json { "mcpServers": { "prysm-standard": { "description": "Standard web scraping with default settings", "command": "npx", "args": ["-y", "@pinkpixel/prysm-mcp"] }, "prysm-with-output": { "description": "Web scraping with custom output directory", "command": "npx", "args": ["-y", "@pinkpixel/prysm-mcp"], "env": { "PRYSM_OUTPUT_DIR": "$HOME/roo-scrape-results", "PRYSM_IMAGE_OUTPUT_DIR": "$HOME/roo-scrape-results/images" } } } } ``` After creating this file, import it through the Roo Code MCP settings interface. ## ⚙️ Environment Configuration You can customize where results are saved by setting environment variables before starting Roo Code: ```bash # Linux/macOS export PRYSM_OUTPUT_DIR="/path/to/custom/directory" export PRYSM_IMAGE_OUTPUT_DIR="/path/to/custom/image/directory" # Then start Roo Code # Windows (Command Prompt) set PRYSM_OUTPUT_DIR=C:\path\to\custom\directory set PRYSM_IMAGE_OUTPUT_DIR=C:\path\to\custom\image\directory # Then start Roo Code # Windows (PowerShell) $env:PRYSM_OUTPUT_DIR="C:\path\to\custom\directory" $env:PRYSM_IMAGE_OUTPUT_DIR="C:\path\to\custom\image\directory" # Then start Roo Code ``` By default, general results will be saved to `~/prysm-mcp/output/` and images to `~/prysm-mcp/output/images/`. ## 🚀 Available Tools The Prysm MCP Server provides the following tools: | Tool Name | Description | Key Parameters | |-----------|-------------|----------------| | scrapeFocused | Fast web scraping (fewer scrolls, main content) | `url`, `maxScrolls` (default: 5) | | scrapeBalanced | Balanced scraping (good coverage, reasonable speed) | `url`, `maxScrolls` (default: 10), `timeout` | | scrapeDeep | Maximum extraction (slower but thorough) | `url`, `maxScrolls` (default: 20) | | formatResult | Format data as markdown, HTML, or JSON | `data`, `format`, `output` | ## 📝 Examples Here are some examples of how to use the Prysm MCP tools in Roo Code: ### Simple Scraping Ask Roo to scrape a webpage: ``` Please scrape https://example.com using the balanced mode ``` ### Content Analysis Ask Roo to analyze a URL first: ``` Analyze the structure of https://example.com ``` ### Custom Scraping Ask Roo to use specific parameters: ``` Scrape https://example.com using deep mode with maximum 15 scrolls and download images ``` ### Formatting Results Ask Roo to format the results: ``` Format the scraped data as markdown with images included ``` You can also ask Roo to save the formatted results to a file: ``` Format the scraped data as markdown and save it to "my-results/output.md" ``` Or specify an absolute path: ``` Format the scraped data as HTML and save it to "/home/user/documents/webpages/example.html" ``` If you don't specify a file extension, one will be added automatically based on the format. ## 💡 Tips - For large websites, use `scrapeDeep` for thorough extraction - For blog articles, use `scrapeFocused` for faster extraction of main content - For product pages, use `scrapeBalanced` for a good mix of content and images - Always analyze a URL first if you're unsure which scraping mode to use - When saving formatted results, specify just a filename to save in the default directory - Use the environment variable for consistent output locations across projects ## 🔒 Security Notes - The server runs locally on your machine - No data is sent to external servers (all processing happens locally) - Images are only downloaded if specifically requested - Saved files are stored on your local machine in the configured output directory For more information, visit [Pink Pixel](https://pinkpixel.dev) or check the [GitHub repository](https://github.com/pinkpixel-dev/prysm-mcp).