Support - JinsongRoh/pydoll-mcp GitHub Wiki

๐Ÿ“ž Support - How to Get Help

Having issues with PyDoll MCP Server v1.1.3 or need assistance? This page provides various support methods.

๐Ÿ” Troubleshooting Order

1. ๐Ÿ“š Things to Check First

Before reporting an issue, please check the following:

  • Use Latest Version: Current latest version is v1.1.3
  • Installation Requirements: Python 3.8+ version required
  • Browser Compatibility: Check if Chrome or Edge browser is installed

2. ๐Ÿ› ๏ธ Self-Diagnostic Tools

PyDoll MCP Server provides various diagnostic tools:

# Check installation status
python -m pydoll_mcp.cli test-installation --verbose

# Browser test
python -m pydoll_mcp.cli test-browser --browser chrome

# Check server status
python -m pydoll_mcp.cli status --logs --stats

# MCP server connection test
python -m pydoll_mcp.server --test

๐Ÿ› Common Issues

Installation Issues

Issue: Installation failures

# Check Python version (3.8+ required)
python --version

# Upgrade pip
python -m pip install --upgrade pip

# Reinstall with verbose output
pip install pydoll-mcp -v

Issue: Encoding errors in Korean Windows environment (Fixed in v1.1.3!)

# Set environment variable
set PYTHONIOENCODING=utf-8
python -m pydoll_mcp.server

# Or in Claude Desktop configuration:
{
  "mcpServers": {
    "pydoll": {
      "command": "python",
      "args": ["-m", "pydoll_mcp.server"],
      "env": {
        "PYTHONIOENCODING": "utf-8",
        "PYDOLL_LOG_LEVEL": "INFO"
      }
    }
  }
}

Browser Issues

Issue: Browser fails to start

# Check browser installation
python -c "from pydoll.browser import Chrome; print('Browser check complete')"

# Test basic functionality
python -m pydoll_mcp.cli test-browser

# Check permissions (Linux)
ls -la /usr/bin/google-chrome

MCP Connection Issues (Fixed in v1.1.3!)

Issue: JSON parsing errors

# Upgrade to v1.1.3 (issue resolved)
pip install --upgrade pydoll-mcp

# Verify fix
python -m pydoll_mcp.server --test

# Check server output (should be clean JSON)
python -m pydoll_mcp.cli status

Claude Desktop Configuration Issues

Issue: Not connecting with Claude Desktop

# Re-run automatic setup
python -m pydoll_mcp.cli auto-setup --force

# Check configuration status
python -m pydoll_mcp.cli status

# Generate manual configuration file
python -m pydoll_mcp.cli generate-config --auto-setup

๐Ÿ†˜ How to Request Help

1. [GitHub Issues](https://github.com/JinsongRoh/pydoll-mcp/issues) (Official Support Channel)

The most effective support method:

๐Ÿ”— Link: [GitHub Issues](https://github.com/JinsongRoh/pydoll-mcp/issues)

Information to include when reporting bugs:

  • Operating system and version
  • Python version
  • PyDoll MCP Server version
  • Complete error message
  • Reproducible steps
  • Expected behavior vs actual behavior

Bug Report Template:

## ๐Ÿ› Bug Report

### Environment Information
- OS: [e.g., Windows 11, macOS 14.0, Ubuntu 22.04]
- Python Version: [e.g., Python 3.9.7]
- PyDoll MCP Server Version: [e.g., v1.1.3]
- Browser: [e.g., Chrome 115.0]

### Issue Description
[Clear and concise description of the issue]

### Steps to Reproduce
1. [First step]
2. [Second step]
3. [Third step]

### Expected Behavior
[Expected result]

### Actual Behavior
[Actual result]

### Screenshots
[If possible, attach screenshots]

### Additional Information
[Any other relevant information]

2. Community Support

GitHub Discussions: [Discussion Board](https://github.com/JinsongRoh/pydoll-mcp/discussions)

  • Questions and answers
  • Sharing usage tips
  • Feature suggestions
  • General discussions

3. Documentation and Resources

Wiki Documentation: [PyDoll MCP Wiki](https://github.com/JinsongRoh/pydoll-mcp/wiki)

  • Detailed usage guides
  • Troubleshooting guides
  • Best practices
  • Example codes

Reference Materials:

๐Ÿค Contributing to the Project

PyDoll MCP Server is an open-source project. You can contribute in the following ways:

Code Contribution

# Fork and clone repository
git clone https://github.com/JinsongRoh/pydoll-mcp.git
cd pydoll-mcp

# Set up development environment
python -m venv venv
source venv/bin/activate  # Linux/macOS
# or venv\Scripts\activate  # Windows

# Install development dependencies
pip install -e ".[dev]"

# Run tests
python -m pytest tests/ -v

# Set up pre-commit hooks
pre-commit install

Types of Contributions

  • ๐Ÿ› Bug Fixes: Finding and fixing issues
  • โœจ New Features: Adding useful features
  • ๐Ÿ“š Documentation Improvement: Improving guides, examples, API documentation
  • ๐Ÿงช Test Addition: Improving test coverage
  • ๐ŸŒ Translation: Multi-language support

Contributing Guide: [CONTRIBUTING.md](https://github.com/JinsongRoh/pydoll-mcp/blob/main/CONTRIBUTING.md)

๐Ÿ“‹ Support Priority

Immediate Response (Critical)

  • Server startup failure
  • Security-related issues
  • Data loss risk

Rapid Response (High)

  • Major feature malfunctions
  • Performance degradation issues
  • Browser compatibility issues

Standard Response (Medium)

  • Feature improvement requests
  • Usability issues
  • Documentation improvements

Long-term Planning (Low)

  • New platform support
  • Advanced feature additions
  • UI/UX improvements

๐Ÿ”’ Security Issues

If you discover security-related vulnerabilities:

  1. Do not disclose publicly: Report privately instead of immediate public disclosure
  2. Email contact: Contact repository owner directly
  3. Provide detailed information: Detailed information about the vulnerability and reproduction method

๐Ÿ’ Supporting the Project

If you find PyDoll MCP Server useful:

๐Ÿ“ž Contact Information

๐Ÿ’ก Tip: Before reporting an issue, please check the [FAQ](https://github.com/JinsongRoh/pydoll-mcp/wiki/FAQ) and [Troubleshooting Guide](https://github.com/JinsongRoh/pydoll-mcp/wiki/Troubleshooting) first. You can find solutions to most common issues.

This document is continuously updated. Check the [GitHub Wiki](https://github.com/JinsongRoh/pydoll-mcp/wiki) for the latest information.