test-mcp-server-ap25092201 0.1.10
Test MCP Server with media handling and prompt capabilities for bootstrap testing
License: MIT
Requires Python: >=3.10
Keywords: ai, assistant, bootstrap, mcp, media, prompts, server, testing

# test-mcp-server-ap25092201

[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)

A test MCP (Model Context Protocol) server implementation with media handling and prompt capabilities, designed for testing bootstrap scripts and demonstrating MCP integration patterns.

## Overview

This package provides a complete MCP server implementation that includes:

- **Media Handler**: Image and audio processing capabilities with PyAutoGUI integration
- **Prompt Server**: FastMCP-based server with resource management and prompt handling
- **Bootstrap Testing**: Designed to test mcp-python-bootstrap project

## Features

- 🖼️ **Image Processing**: Image proccesing using PyAutoGUI
- 🎵 **Audio Handling**: Audio resource management and processing
- 🔧 **MCP Protocol**: Full Model Context Protocol implementation using FastMCP
- 🚀 **Bootstrap Ready**: Prepared for migration from Poetry to uv for bootstrap testing

## Installation

### From PyPI

```bash
pip install test-mcp-server-ap25092201
```

### From GitHub

```bash
pip install git+https://github.com/apisani1/test-mcp-server-ap25092201.git
```

## Quick Start

### Running the MCP Server

```bash
# Using the package directly
python -m test_mcp_server_ap25092201.prompt_server

# Or using make commands for development
make run prompt_server
```

## Development

### Prerequisites

- Python 3.10+
- uv for dependency management
- Git for version control

### Setup Development Environment

```bash
# Clone the repository
git clone https://github.com/apisani1/test-mcp-server-ap25092201.git
cd test-mcp-server-ap25092201

# Install uv if not already installed
pip install uv

# Install dependencies
make install-dev

# Run tests
make test

# Run linting
make lint

# Format code
make format
```

### Available Make Commands

```bash
make install      # Install core dependencies
make install-dev  # Install development dependencies
make test         # Run test suite
make lint         # Run linting checks
make format       # Format code with black/isort
make docs         # Build documentation
make build        # Build distribution packages
make publish-test # Publish to TestPyPI
make publish      # Publish to PyPI
```

## Testing Bootstrap Compatibility

This package is specifically designed to test the mcp-python-bootstrap project:

1. **Current State**: Uses uv for dependency management
2. **Bootstrap Ready**: Prepared for bootstrap script compatibility testing
3. **Testing Target**: Validates bootstrap scripts can properly handle MCP server packages

## Project Structure

```
src/test_mcp_server_ap25092201/
├── __init__.py           # Package initialization
├── media_handler.py      # Image and audio processing
├── prompt_client.py      # OpenAI client integration
└── prompt_server.py      # Main MCP server implementation
```

## Dependencies

### Core Dependencies
- `mcp[cli]` - Model Context Protocol implementation
- `openai` - OpenAI API client
- `pyautogui` - GUI automation and screenshot capabilities
- `pyscreeze` - Screen capture utilities
- `pillow` - Image processing library

### Development Dependencies
- `pytest` - Testing framework
- `black` - Code formatting
- `flake8` - Linting
- `mypy` - Type checking


## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Related Projects

- [mcp-python-bootstrap](https://github.com/your-org/mcp-python-bootstrap) - Bootstrap scripts for MCP projects
- [FastMCP](https://github.com/jlowin/fastmcp) - Fast MCP server implementation

## Support

- 📖 [Documentation](https://test-mcp-server-ap25092201.readthedocs.io/)
- 🐛 [Issue Tracker](https://github.com/apisani1/test-mcp-server-ap25092201/issues)
- 💬 [Discussions](https://github.com/apisani1/test-mcp-server-ap25092201/discussions)

---

**Note**: This is a test package designed for bootstrap validation. For production MCP servers, consider using the patterns demonstrated here as a starting point for your own implementation.