My MCP Servers

A collection of custom MCP (Model Context Protocol) servers providing various services including calendar management and weather information.

For more information about building MCP servers, see the official MCP documentation.

Features

• Calendar Service: Integration with Google Calendar API for event management
• Weather Service: Weather information and forecasting capabilities
• Sound Control Service: Basic playback controls for the Music app on macOS

System Requirements

• Python 3.10 or higher
• MCP SDK 1.2.0 or higher
• Google Calendar API credentials (credentials.json)

Environment Setup

1. Install uv (MacOS/Linux):

curl -LsSf https://astral.sh/uv/install.sh | sh

Note: Restart your terminal after installing uv to ensure the command is available.

2. Clone the repository:

git clone <your-repository-url>
cd my-mcp-servers

3. Sync your environment:

uv sync

4. Test if it's working:

uv run weather/weather.py

Configuration

1. Place your Google Calendar API credentials in credentials.json
   • To obtain your credentials, follow the Google Calendar API Python Quickstart Guide Note: The authentication token will be automatically generated on first use of the calendar service.

Services

Calendar Service

The calendar service provides integration with Google Calendar, allowing you to:

• Create and manage calendar events
• List upcoming events
• Set up recurring meetings

Weather Service

The weather service offers:

• Weather forecasts
• Weather alerts
• Location-based weather information

Sound Control Service

This service exposes simple playback controls for macOS. It can:

• Play or pause the current track
• Skip to the next track
• Return to the previous track

License

This project is licensed under the MIT License - see the LICENSE file for details.