Prysm MCP Server

# 🔍 Using Prysm MCP Server with Cline This guide explains how to integrate the Prysm MCP Server with Cline 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 Cline to use the Prysm MCP Server. Cline offers several ways to add MCP servers: - Ask Cline to help you set up an MCP server - Use the Cline MCP Marketplace - Add an MCP server configuration manually ## 🛠️ Configuration Options ### Basic Configuration To add the Prysm MCP Server to Cline, create a configuration for it in your Cline settings: ```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/cline-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" } } } ``` ### Configuration via Cline's Interface You can also ask Cline to help you set up the Prysm MCP Server by saying: ``` I want to add the Prysm MCP server to help me scrape web content ``` Cline will guide you through the setup process and configure everything correctly. ### Custom Configuration You can create a custom configuration file to add the Prysm MCP Server to Cline. Create a file named `mcp.json` in your Cline configuration directory: ```json { "mcpServers": { "prysm-scraper": { "command": "npx", "args": ["-y", "@pinkpixel/prysm-mcp"], "env": { "PRYSM_OUTPUT_DIR": "$HOME/cline-scrape-results", "PRYSM_IMAGE_OUTPUT_DIR": "$HOME/cline-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/cline-scrape-results", "PRYSM_IMAGE_OUTPUT_DIR": "$HOME/cline-scrape-results/images" } } } } ``` After saving this file, restart Cline for the changes to take effect. ## ⚙️ Environment Configuration You can customize where results are saved by setting environment variables before starting Cline: ```bash # Linux/macOS export PRYSM_OUTPUT_DIR="/path/to/custom/directory" export PRYSM_IMAGE_OUTPUT_DIR="/path/to/custom/image/directory" # Then start Cline # 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 Cline # Windows (PowerShell) $env:PRYSM_OUTPUT_DIR="C:\path\to\custom\directory" $env:PRYSM_IMAGE_OUTPUT_DIR="C:\path\to\custom\image\directory" # Then start Cline ``` 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 Cline: ### Simple Scraping Ask Cline to scrape a webpage: ``` Please scrape https://example.com using the balanced mode ``` ### Content Analysis Ask Cline to analyze a URL first: ``` Analyze the structure of https://example.com ``` ### Custom Scraping Ask Cline to use specific parameters: ``` Scrape https://example.com using deep mode with maximum 15 scrolls and download images ``` ### Formatting Results Ask Cline to format the results: ``` Format the scraped data as markdown with images included ``` You can also ask Cline 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 - Cline can help you troubleshoot any issues with the server setup ## 🔒 Security Considerations When using MCP servers with Cline, follow these security best practices: - 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 - Always use secure authentication methods for API access if needed - Store sensitive information in environment variables - Limit server access to authorized users only For more information, visit [Pink Pixel](https://pinkpixel.dev) or check the [GitHub repository](https://github.com/pinkpixel-dev/prysm-mcp).