Swapnil MCP Server

A Model Context Protocol (MCP) server that provides automated utilities for Outlook Calendar scheduling, Microsoft Visual Studio Team Foundation Server repository management, and weather information retrieval.

Features

• Create and schedule meetings in Microsoft Outlook calendar with automated settings for reminders and status
• Retrieve project repositories from Microsoft Visual Studio Team Foundation Server
• Get current weather information for any city worldwide through OpenWeatherMap API

Installation

pip install swapnil-mcp-server

Requirements

• Python 3.9 or higher
• Windows OS (requires Microsoft Outlook and optionally Microsoft Teams)
• pywin32 package
• mcp package version 1.2.0 or higher

Usage

Starting the Server

# Run as a command
swapnil-mcp-server

# Or import in your Python code
from mcp_tools.server import mcp
mcp.run()

Using with MCP Clients

This package implements the Model Context Protocol (MCP), allowing AI assistants and other MCP-compatible clients to interact with your Outlook calendar.

Example of how an MCP client might use this tool:

from mcp.client import Client

client = Client()
result = await client.Set_Meeting(
    subject="Team Meeting",
    start_date="2023-10-01T10:00:00",
    end_date="2023-10-01T11:00:00"
)
print(result)  # Meeting with subject 'Team Meeting' set from 2023-10-01T10:00:00 to 2023-10-01T11:00:00.

API Reference

Set_Meeting

Creates and schedules a meeting in Microsoft Outlook with automated configuration for reminders, status, and sending.

Parameters:

• subject (string, required): Meeting subject
• start_date (string, required): Start date and time in ISO format (e.g., "2023-10-01T10:00:00")
• end_date (string, required): End date and time in ISO format (e.g., "2023-10-01T11:00:00")

Features:

• Automatically sets a 15-minute reminder
• Sets busy status
• Configures as an all-day event
• Automatically sends the meeting invitation

Returns:

• A confirmation message with the meeting details

Get_Project_Repositories

Retrieves repositories from a specified Microsoft Visual Studio Team Foundation Server project.

Parameters:

• project_name (string, required): Name of the Microsoft Visual Studio Team Foundation Server project

Returns:

• List of repository names in the specified project, or an error message if the operation fails

Get_Repository_Checkins

Retrieves commit history from a specified repository in Microsoft Visual Studio Team Foundation Server.

Parameters:

• project_name (string, required): Name of the project in Microsoft Visual Studio Team Foundation Server
• repository_name (string, required): Name of the repository to check
• userupn (string, required): User UPN to filter commits by author

Features:

• Filters commits by specific user
• Returns detailed commit information including IDs, authors, dates, and messages
• Requires TFS_PAT environment variable for authentication
• Supports secure HTTPS connections

Returns:

• List of commit details or appropriate error message

get_weather

Retrieves current weather information for a specified city using OpenWeatherMap.

Parameters:

• city (string, required): Name of the city (any global city)

Returns:

• Dictionary containing:
  • location: City name and country
  • temperature: Current, feels like, min, and max temperatures
  • humidity: Current humidity percentage
  • wind: Speed and direction
  • description: Weather description
  • timestamp: Time of the weather reading

Available Tools

Development

Project Structure

swapnil-mcp-server/
├── src/
│   └── mcp_tools/
│       ├── __init__.py
│       ├── __main__.py
│       └── server.py
├── LICENSE
├── README.md
└── pyproject.toml

Building and Publishing

python -m build
python -m twine upload dist/*

License

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

Author

• Swapnil Dagade (swapnildagade@gmail.com)

Links

• GitHub Repository
• Bug Tracker
• Documentation