screenmonitormcp-v2


Namescreenmonitormcp-v2 JSON
Version 2.0.3 PyPI version JSON
download
home_pageNone
SummaryA revolutionary Model Context Protocol (MCP) server that gives AI real-time vision capabilities and enhanced UI intelligence power
upload_time2025-07-31 09:51:16
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT
keywords mcp screen monitor capture ai vision automation
VCS
bugtrack_url
requirements fastapi uvicorn mss Pillow python-multipart pygetwindow python-dotenv openai mcp opencv-python numpy pytesseract easyocr pyautogui scikit-learn pandas structlog tenacity psutil
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # ScreenMonitorMCP v2

[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/a2dbda0f-f46d-40e1-9c13-0b47eff9df3a)
[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/inkbytefo-screenmonitormcp-badge.png)](https://mseep.ai/app/inkbytefo-screenmonitormcp)
A powerful Model Context Protocol (MCP) server that gives AI real-time vision capabilities and enhanced UI intelligence. Transform your AI assistant into a visual powerhouse that can see, analyze, and interact with your screen content.

## What is ScreenMonitorMCP?

ScreenMonitorMCP v2 is a revolutionary MCP server that bridges the gap between AI and visual computing. It enables AI assistants to capture screenshots, analyze screen content, and provide intelligent insights about what's happening on your display.

## Key Features

- **Real-time Screen Capture**: Instant screenshot capabilities across multiple monitors
- **AI-Powered Analysis**: Advanced screen content analysis using state-of-the-art vision models
- **Streaming Support**: Live screen streaming for continuous monitoring
- **Performance Monitoring**: Built-in system health and performance metrics
- **Multi-Platform**: Works seamlessly on Windows, macOS, and Linux
- **Easy Integration**: Simple setup with Claude Desktop and other MCP clients

## Quick Start

### Installation

```bash
# Install from PyPI
pip install screenmonitormcp

# Or install from source
git clone https://github.com/inkbytefo/screenmonitormcp.git
cd screenmonitormcp
pip install -e .
```

### Configuration

1. Create a `.env` file with your AI service credentials:

```env
OPENAI_API_KEY=your-api-key-here
OPENAI_MODEL=gpt-4o
```

2. Add to your Claude Desktop config:

```json
{
  "mcpServers": {
    "screenmonitormcp-v2": {
      "command": "python",
      "args": ["-m", "screenmonitormcp_v2.mcp_main"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here",
        "OPENAI_BASE_URL": "https://openrouter.ai/api/v1",
        "OPENAI_MODEL": "qwen/qwen2.5-vl-32b-instruct:free"
      }
    }
  }
}
```

3. Restart Claude Desktop and start capturing!

## Available Tools

- `capture_screen` - Take screenshots of any monitor
- `analyze_screen` - AI-powered screen content analysis
- `analyze_image` - Analyze any image with AI vision
- `create_stream` - Start live screen streaming
- `get_performance_metrics` - System health monitoring

## Use Cases

- **UI/UX Analysis**: Get AI insights on interface design and usability
- **Debugging Assistance**: Visual debugging with AI-powered error detection
- **Content Creation**: Automated screenshot documentation and analysis
- **Accessibility Testing**: Screen reader and accessibility compliance checking
- **System Monitoring**: Visual system health and performance tracking

## Documentation

For detailed setup instructions and advanced configuration, see our [MCP Setup Guide](MCP_SETUP_GUIDE.md).

## Requirements

- Python 3.8+
- OpenAI API key (or compatible service)
- MCP-compatible client (Claude Desktop, etc.)

## Contributing

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License

MIT License - see [LICENSE](LICENSE) for details.

## Previous Version

Looking for v1? Check the [v1 branch](https://github.com/inkbytefo/ScreenMonitorMCP/tree/v1) for the previous version.

---

**Built with ❤️ by [inkbytefo](https://github.com/inkbytefo)**

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "screenmonitormcp-v2",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "inkbytefo <inkbytefo@gmail.com>",
    "keywords": "mcp, screen, monitor, capture, ai, vision, automation",
    "author": null,
    "author_email": "inkbytefo <inkbytefo@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/b7/9b/3c947ea320b20342509472f4f18e88c4f5ea906fbbdede073907491579bd/screenmonitormcp_v2-2.0.3.tar.gz",
    "platform": null,
    "description": "# ScreenMonitorMCP v2\r\n\r\n[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/a2dbda0f-f46d-40e1-9c13-0b47eff9df3a)\r\n[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/inkbytefo-screenmonitormcp-badge.png)](https://mseep.ai/app/inkbytefo-screenmonitormcp)\r\nA powerful Model Context Protocol (MCP) server that gives AI real-time vision capabilities and enhanced UI intelligence. Transform your AI assistant into a visual powerhouse that can see, analyze, and interact with your screen content.\r\n\r\n## What is ScreenMonitorMCP?\r\n\r\nScreenMonitorMCP v2 is a revolutionary MCP server that bridges the gap between AI and visual computing. It enables AI assistants to capture screenshots, analyze screen content, and provide intelligent insights about what's happening on your display.\r\n\r\n## Key Features\r\n\r\n- **Real-time Screen Capture**: Instant screenshot capabilities across multiple monitors\r\n- **AI-Powered Analysis**: Advanced screen content analysis using state-of-the-art vision models\r\n- **Streaming Support**: Live screen streaming for continuous monitoring\r\n- **Performance Monitoring**: Built-in system health and performance metrics\r\n- **Multi-Platform**: Works seamlessly on Windows, macOS, and Linux\r\n- **Easy Integration**: Simple setup with Claude Desktop and other MCP clients\r\n\r\n## Quick Start\r\n\r\n### Installation\r\n\r\n```bash\r\n# Install from PyPI\r\npip install screenmonitormcp\r\n\r\n# Or install from source\r\ngit clone https://github.com/inkbytefo/screenmonitormcp.git\r\ncd screenmonitormcp\r\npip install -e .\r\n```\r\n\r\n### Configuration\r\n\r\n1. Create a `.env` file with your AI service credentials:\r\n\r\n```env\r\nOPENAI_API_KEY=your-api-key-here\r\nOPENAI_MODEL=gpt-4o\r\n```\r\n\r\n2. Add to your Claude Desktop config:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"screenmonitormcp-v2\": {\r\n      \"command\": \"python\",\r\n      \"args\": [\"-m\", \"screenmonitormcp_v2.mcp_main\"],\r\n      \"env\": {\r\n        \"OPENAI_API_KEY\": \"your-openai-api-key-here\",\r\n        \"OPENAI_BASE_URL\": \"https://openrouter.ai/api/v1\",\r\n        \"OPENAI_MODEL\": \"qwen/qwen2.5-vl-32b-instruct:free\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n3. Restart Claude Desktop and start capturing!\r\n\r\n## Available Tools\r\n\r\n- `capture_screen` - Take screenshots of any monitor\r\n- `analyze_screen` - AI-powered screen content analysis\r\n- `analyze_image` - Analyze any image with AI vision\r\n- `create_stream` - Start live screen streaming\r\n- `get_performance_metrics` - System health monitoring\r\n\r\n## Use Cases\r\n\r\n- **UI/UX Analysis**: Get AI insights on interface design and usability\r\n- **Debugging Assistance**: Visual debugging with AI-powered error detection\r\n- **Content Creation**: Automated screenshot documentation and analysis\r\n- **Accessibility Testing**: Screen reader and accessibility compliance checking\r\n- **System Monitoring**: Visual system health and performance tracking\r\n\r\n## Documentation\r\n\r\nFor detailed setup instructions and advanced configuration, see our [MCP Setup Guide](MCP_SETUP_GUIDE.md).\r\n\r\n## Requirements\r\n\r\n- Python 3.8+\r\n- OpenAI API key (or compatible service)\r\n- MCP-compatible client (Claude Desktop, etc.)\r\n\r\n## Contributing\r\n\r\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\r\n\r\n## License\r\n\r\nMIT License - see [LICENSE](LICENSE) for details.\r\n\r\n## Previous Version\r\n\r\nLooking for v1? Check the [v1 branch](https://github.com/inkbytefo/ScreenMonitorMCP/tree/v1) for the previous version.\r\n\r\n---\r\n\r\n**Built with \u2764\ufe0f by [inkbytefo](https://github.com/inkbytefo)**\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A revolutionary Model Context Protocol (MCP) server that gives AI real-time vision capabilities and enhanced UI intelligence power",
    "version": "2.0.3",
    "project_urls": {
        "Bug Tracker": "https://github.com/inkbytefo/ScreenMonitorMCP/issues",
        "Changelog": "https://github.com/inkbytefo/ScreenMonitorMCP/blob/main/CHANGELOG.md",
        "Documentation": "https://github.com/inkbytefo/ScreenMonitorMCP/blob/main/README.md",
        "Homepage": "https://github.com/inkbytefo/ScreenMonitorMCP",
        "Repository": "https://github.com/inkbytefo/ScreenMonitorMCP"
    },
    "split_keywords": [
        "mcp",
        " screen",
        " monitor",
        " capture",
        " ai",
        " vision",
        " automation"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b1ca6b3b4118f91355d657b85c79251968537cd09dfa5c94245c883bcf9b5c2c",
                "md5": "bb6ea7a8b672972dba199a5a7b012774",
                "sha256": "dbbc8f1f8a8460f3beb389dbf1e8a2b3f339b29f0fe060e43884e621607f22de"
            },
            "downloads": -1,
            "filename": "screenmonitormcp_v2-2.0.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bb6ea7a8b672972dba199a5a7b012774",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 49545,
            "upload_time": "2025-07-31T09:51:14",
            "upload_time_iso_8601": "2025-07-31T09:51:14.564175Z",
            "url": "https://files.pythonhosted.org/packages/b1/ca/6b3b4118f91355d657b85c79251968537cd09dfa5c94245c883bcf9b5c2c/screenmonitormcp_v2-2.0.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b79b3c947ea320b20342509472f4f18e88c4f5ea906fbbdede073907491579bd",
                "md5": "a83fffc33bb5255a405a56fe9d90bc0c",
                "sha256": "69661aa4e5de33aa9a105ed21fee3d9ffb8567488f099d4e863890b576c75aff"
            },
            "downloads": -1,
            "filename": "screenmonitormcp_v2-2.0.3.tar.gz",
            "has_sig": false,
            "md5_digest": "a83fffc33bb5255a405a56fe9d90bc0c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 45968,
            "upload_time": "2025-07-31T09:51:16",
            "upload_time_iso_8601": "2025-07-31T09:51:16.059885Z",
            "url": "https://files.pythonhosted.org/packages/b7/9b/3c947ea320b20342509472f4f18e88c4f5ea906fbbdede073907491579bd/screenmonitormcp_v2-2.0.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-31 09:51:16",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "inkbytefo",
    "github_project": "ScreenMonitorMCP",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [
        {
            "name": "fastapi",
            "specs": []
        },
        {
            "name": "uvicorn",
            "specs": []
        },
        {
            "name": "mss",
            "specs": []
        },
        {
            "name": "Pillow",
            "specs": []
        },
        {
            "name": "python-multipart",
            "specs": []
        },
        {
            "name": "pygetwindow",
            "specs": []
        },
        {
            "name": "python-dotenv",
            "specs": []
        },
        {
            "name": "openai",
            "specs": []
        },
        {
            "name": "mcp",
            "specs": []
        },
        {
            "name": "opencv-python",
            "specs": []
        },
        {
            "name": "numpy",
            "specs": []
        },
        {
            "name": "pytesseract",
            "specs": []
        },
        {
            "name": "easyocr",
            "specs": []
        },
        {
            "name": "pyautogui",
            "specs": []
        },
        {
            "name": "scikit-learn",
            "specs": []
        },
        {
            "name": "pandas",
            "specs": []
        },
        {
            "name": "structlog",
            "specs": []
        },
        {
            "name": "tenacity",
            "specs": []
        },
        {
            "name": "psutil",
            "specs": []
        }
    ],
    "lcname": "screenmonitormcp-v2"
}
        
Elapsed time: 1.30407s