Metadata-Version: 2.4
Name: helping-geek-mcp
Version: 0.0.1
Summary: A Model Context Protocol (MCP) server providing basic demonstration of MCP tools and utilities
Author-email: Helping Geek <helpinggeek1234@gmail.com>
Maintainer-email: Helping Geek <helpinggeek1234@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/helpinggeek1234-droid/helping-geek-mcp
Project-URL: Documentation, https://github.com/helpinggeek1234-droid/helping-geek-mcp/blob/main/README.md
Project-URL: Repository, https://github.com/helpinggeek1234-droid/helping-geek-mcp
Project-URL: Issues, https://github.com/helpinggeek1234-droid/helping-geek-mcp/issues
Project-URL: Changelog, https://github.com/helpinggeek1234-droid/helping-geek-mcp/blob/main/python-server/CHANGELOG.md
Keywords: mcp,model-context-protocol,sample,demo,utilities
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: build>=0.10.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Provides-Extra: test
Requires-Dist: pytest>=7.0.0; extra == "test"
Requires-Dist: pytest-cov>=4.0.0; extra == "test"
Requires-Dist: pytest-mock>=3.10.0; extra == "test"

# Helping Geek MCP Server

A sample Model Context Protocol (MCP) server demonstrating basic utilities and tools for educational purposes.

## What is This?

This is a demonstration MCP (Model Context Protocol) server created as a proof-of-concept for publishing Python packages to PyPI. It showcases the basic structure and components needed for an MCP server without containing production-level functionality.

## Features

- **Basic String Operations**: Simple text manipulation utilities
- **Data Processing**: Basic data transformation functions
- **Template Management**: Simple template handling demonstrations
- **Configuration**: Example configuration management

This is a sample project designed for learning and testing the PyPI publishing workflow.

## Quick Setup

### 1. Install the Server

```bash
pip install helping-geek-mcp
```

### 2. Configure Your AI Assistant

#### For Cline (VS Code Extension)

Add this to your Cline MCP settings:

```json
{
  "mcpServers": {
    "helping-geek-mcp": {
      "timeout": 60,
      "command": "helping-geek-mcp",
      "args": ["start"],
      "env": {}
    }
  }
}
```

#### For Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "helping-geek-mcp": {
      "command": "helping-geek-mcp",
      "args": ["start"]
    }
  }
}
```

## Development

### Install for Development

```bash
git clone https://github.com/helpinggeek/helping-geek-mcp.git
cd helping-geek-mcp
pip install -e ".[dev]"
```

### Run Tests

```bash
pytest
```

### Build Package

```bash
python -m build
```

### Publish to PyPI

```bash
twine upload dist/*
```

## Project Structure

```
python-server/
├── src/
│   └── helping_geek_mcp/
│       ├── server.py
│       ├── config/
│       ├── prompts/
│       ├── services/
│       ├── tools/
│       └── utils/
├── tests/
├── docs/
├── pyproject.toml
├── README.md
└── LICENSE
```

## License

MIT License - See LICENSE file for details

## Contact

For questions or feedback, reach out to helpinggeek1234@gmail.com

## Disclaimer

This is a sample project for educational purposes and PyPI publishing demonstration. Not intended for production use.
