MCP Practice - Collection of MCP Servers
This repository contains a collection of MCP (Model Context Protocol) servers, each providing different functionality for AI assistants.
📦 Available Servers
🎭 Playwright Browser (servers/playwright-browser)
Browser automation server using Playwright. Navigate websites, extract content, take screenshots, and interact with web pages.
Features:
- Navigate to URLs
- Extract page content (text or HTML)
- Get page titles
- Take screenshots
- Click elements, type text, wait for selectors
See servers/playwright-browser/README.md for detailed documentation.
🚀 Quick Start
Installation
- Install all dependencies:
npm run install:all
- Install Playwright browsers (for playwright-browser server):
npm run setup:playwright
Or install dependencies for a specific server:
cd servers/playwright-browser
npm install
npx playwright install chromium
⚙️ Configuration
For Cursor IDE
Cursor uses an MCP configuration file located at:
- Windows:
%USERPROFILE%\.cursor\mcp.json(e.g.,C:\Users\YourName\.cursor\mcp.json) - macOS/Linux:
~/.cursor/mcp.json
Quick Setup (Windows)
-
Automated setup: Run the provided PowerShell script:
powershell -ExecutionPolicy Bypass -File setup-cursor-config.ps1 -
Manual setup: Create or edit the file at
C:\Users\YourName\.cursor\mcp.jsonand add:{ "mcpServers": { "playwright-browser": { "command": "node", "args": [ "C:\\path\\to\\mcp-practice\\servers\\playwright-browser\\src\\server.js" ], "cwd": "C:\\path\\to\\mcp-practice\\servers\\playwright-browser" } } }Important: Replace
C:\\path\\to\\mcp-practicewith the actual path to your project directory.
Quick Setup (macOS/Linux)
-
Create the directory if it doesn't exist:
mkdir -p ~/.cursor -
Create or edit
~/.cursor/mcp.json:{ "mcpServers": { "playwright-browser": { "command": "node", "args": [ "/full/path/to/mcp-practice/servers/playwright-browser/src/server.js" ], "cwd": "/full/path/to/mcp-practice/servers/playwright-browser" } } }
After Configuration
- Restart Cursor completely for the changes to take effect
- The MCP server will automatically start when you use browser-related prompts
- Verify it's working by trying: "Navigate to https://example.com and summarize the page"
For Claude Desktop (Alternative)
If you're using Claude Desktop instead:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
📝 Adding a New MCP Server
To add a new MCP server:
-
Create a new directory under
servers/:mkdir servers/your-server-name mkdir servers/your-server-name/src -
Create a
package.jsonin the new server directory with:- Server-specific dependencies
- A
startscript pointing to your server entry point
-
Create your server implementation in
servers/your-server-name/src/server.js -
Update
setup-cursor-config.ps1to include your new server in the configuration -
Add documentation in
servers/your-server-name/README.md
🏗️ Project Structure
mcp-practice/
├── servers/ # All MCP servers
│ ├── playwright-browser/ # Playwright browser automation server
│ │ ├── src/
│ │ │ └── server.js # Server implementation
│ │ ├── package.json # Server dependencies
│ │ └── README.md # Server documentation
│ └── [future servers...] # Add more servers here
├── package.json # Root workspace configuration
├── setup-cursor-config.ps1 # Cursor configuration setup script
├── cursor-mcp-config.json # Example Cursor config
├── mcp-config.json # Example MCP config
└── README.md # This file
📚 Usage Examples
Playwright Browser Server
Once configured, you can use prompts like:
- "Navigate to https://example.com and summarize the page."
- "Go to https://example.com and get the page title."
- "Take a screenshot of https://example.com"
- "Navigate to https://example.com, click the button with selector '#submit', and tell me what happened."
🔧 Development
Running a Server Directly
To test a server directly:
cd servers/playwright-browser
npm start
Or:
node servers/playwright-browser/src/server.js
Note: Servers communicate via stdio, so they're designed to be used by MCP clients rather than run standalone.
📄 License
MIT