demo-mcp-server


Namedemo-mcp-server JSON
Version 1.0.2 PyPI version JSON
download
home_pageNone
SummaryMCP server providing math operations and OnceHub booking calendar integration
upload_time2025-10-23 17:32:50
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseMIT
keywords booking calendar math mcp oncehub server
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Demo MCP Server

A Model Context Protocol (MCP) server providing math operations and OnceHub booking calendar integration.

[![PyPI version](https://badge.fury.io/py/demo-mcp-server.svg)](https://badge.fury.io/py/demo-mcp-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Features

### 🧮 Math Tools
- **add**: Add two numbers together with input validation

### 📅 Booking Tools
- **get_booking_time_slots**: Retrieve all available time slots from OnceHub booking calendars
- **schedule_meeting**: Book meetings with participant details and location preferences

## Installation

```bash
pip install demo-mcp-server
```

Or with uv:
```bash
uv add demo-mcp-server
```

## Configuration

### API Key Setup

The OnceHub API key is configured once during integration:

#### For Claude Desktop:

```json
{
  "mcpServers": {
    "demo-mcp-server": {
      "command": "demo-mcp-server",
      "env": {
        "ONCEHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

#### For Command Line:

```bash
# Set environment variable
export ONCEHUB_API_KEY="your_api_key_here"

# Run server
demo-mcp-server
```

#### For Windows:

```cmd
set ONCEHUB_API_KEY=your_api_key_here
demo-mcp-server
```

## Usage

Once configured, you can use the tools without specifying the API key:

```
# Get available slots
"Get booking slots for calendar 'cal_123'"

# Schedule meeting  
"Schedule a meeting for calendar 'cal_123' on 2024-01-15 at 2:30 PM EST for John Doe (john@example.com)"
```

## Development

```bash
git clone https://github.com/yourusername/demo-mcp-server.git
cd demo-mcp-server
uv sync
```

## License

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

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "demo-mcp-server",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "booking, calendar, math, mcp, oncehub, server",
    "author": null,
    "author_email": "Nikhil <your.email@example.com>",
    "download_url": "https://files.pythonhosted.org/packages/6b/85/733851e527a0caed9e72485caf7127029e11866be0e863c9f0b5aa0e8b26/demo_mcp_server-1.0.2.tar.gz",
    "platform": null,
    "description": "# Demo MCP Server\n\nA Model Context Protocol (MCP) server providing math operations and OnceHub booking calendar integration.\n\n[![PyPI version](https://badge.fury.io/py/demo-mcp-server.svg)](https://badge.fury.io/py/demo-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Features\n\n### \ud83e\uddee Math Tools\n- **add**: Add two numbers together with input validation\n\n### \ud83d\udcc5 Booking Tools\n- **get_booking_time_slots**: Retrieve all available time slots from OnceHub booking calendars\n- **schedule_meeting**: Book meetings with participant details and location preferences\n\n## Installation\n\n```bash\npip install demo-mcp-server\n```\n\nOr with uv:\n```bash\nuv add demo-mcp-server\n```\n\n## Configuration\n\n### API Key Setup\n\nThe OnceHub API key is configured once during integration:\n\n#### For Claude Desktop:\n\n```json\n{\n  \"mcpServers\": {\n    \"demo-mcp-server\": {\n      \"command\": \"demo-mcp-server\",\n      \"env\": {\n        \"ONCEHUB_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### For Command Line:\n\n```bash\n# Set environment variable\nexport ONCEHUB_API_KEY=\"your_api_key_here\"\n\n# Run server\ndemo-mcp-server\n```\n\n#### For Windows:\n\n```cmd\nset ONCEHUB_API_KEY=your_api_key_here\ndemo-mcp-server\n```\n\n## Usage\n\nOnce configured, you can use the tools without specifying the API key:\n\n```\n# Get available slots\n\"Get booking slots for calendar 'cal_123'\"\n\n# Schedule meeting  \n\"Schedule a meeting for calendar 'cal_123' on 2024-01-15 at 2:30 PM EST for John Doe (john@example.com)\"\n```\n\n## Development\n\n```bash\ngit clone https://github.com/yourusername/demo-mcp-server.git\ncd demo-mcp-server\nuv sync\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "MCP server providing math operations and OnceHub booking calendar integration",
    "version": "1.0.2",
    "project_urls": {
        "Documentation": "https://github.com/nikhil1109/demo-mcp-server#readme",
        "Homepage": "https://github.com/nikhil1109/demo-mcp-server",
        "Repository": "https://github.com/nikhil1109/demo-mcp-server"
    },
    "split_keywords": [
        "booking",
        " calendar",
        " math",
        " mcp",
        " oncehub",
        " server"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "2e3e0b26281a94017294ce8fc63bb7dce9873bff4109054aa4e194eb6ff0d43a",
                "md5": "3b06b5956316d08ad1ffc91c59a82fe1",
                "sha256": "65102c69a742b440d09d81f5a7a9a19082f3e2072bc24a5d9b9446c1066c5241"
            },
            "downloads": -1,
            "filename": "demo_mcp_server-1.0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3b06b5956316d08ad1ffc91c59a82fe1",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 55978,
            "upload_time": "2025-10-23T17:32:49",
            "upload_time_iso_8601": "2025-10-23T17:32:49.193647Z",
            "url": "https://files.pythonhosted.org/packages/2e/3e/0b26281a94017294ce8fc63bb7dce9873bff4109054aa4e194eb6ff0d43a/demo_mcp_server-1.0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "6b85733851e527a0caed9e72485caf7127029e11866be0e863c9f0b5aa0e8b26",
                "md5": "5dde01814430a50ad8b689ee61cafb31",
                "sha256": "286d5a418c9ef93a0e8b6d1d124482b2c6b0992893093b5a618fb7593c70dcaf"
            },
            "downloads": -1,
            "filename": "demo_mcp_server-1.0.2.tar.gz",
            "has_sig": false,
            "md5_digest": "5dde01814430a50ad8b689ee61cafb31",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 51268,
            "upload_time": "2025-10-23T17:32:50",
            "upload_time_iso_8601": "2025-10-23T17:32:50.596388Z",
            "url": "https://files.pythonhosted.org/packages/6b/85/733851e527a0caed9e72485caf7127029e11866be0e863c9f0b5aa0e8b26/demo_mcp_server-1.0.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-23 17:32:50",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "nikhil1109",
    "github_project": "demo-mcp-server#readme",
    "github_not_found": true,
    "lcname": "demo-mcp-server"
}
        
Elapsed time: 5.03795s