🧠 MCP Server Project - Multi-Agent AI Tools

This project demonstrates how to build and serve multiple AI tools using the FastMCP framework. It includes a combination of COM-based email automation, external API integration (OpenWeather), local file-based notes, and utility functions—all accessible via an MCP-compatible agent interface.

🔧 Requirements

• Python 3.10+

• Windows (required for Outlook COM)

• .env file with:

  OPENWEATHER_API_KEY=your_openweather_key_here

Related MCP server: pyfastmail-mcp

📁 Directory Structure

. ├── outlook_assistant.py # Outlook email read/reply/compose/search tools ├── weather_mcp.py # Current, forecast, historical, and air quality weather tools ├── sticky_notes.py # Notes tools backed by a text file ├── addition_server.py # Simple addition and greeting tool ├── notes.txt # File to store sticky notes └── README.md # This file

📬 Outlook Email Assistant

A COM-based email assistant that integrates with Microsoft Outlook to:

• List all folders in Outlook

• Fetch and display recent or matching emails

• Read full email contents

• Send replies or compose new emails

🔧 Tools Exposed:

• list_folders()

• list_recent_emails(days, folder_name)

• search_emails(search_term, days, folder_name)

• get_email_by_number(email_number)

• reply_to_email_by_number(email_number, reply_text)

• compose_email(recipient_email, subject, body, cc_email)

⚠️ Must be run on Windows with Microsoft Outlook installed.

🌍 Weather Tools (OpenWeather API)

Provides weather details using OpenWeatherMap API including:

• Current weather

• 5-day forecast

• Air quality

• Weather alerts

• Historical weather (past 5 days)

🌦 Tools Exposed:

• get_current_weather(location)

• get_weather_forecast(location, days)

• get_air_quality(location)

• get_historical_weather(location, date)

• get_weather_alerts(location)

• search_location(query)

🌐 Requires setting OPENWEATHER_API_KEY in .env

📝 AI Sticky Notes

Simple note-taking assistant that stores notes locally in a notes.txt file.

🛠 Tools and Resources:

• add_note(message)

• read_notes()

• get_latest_note() – as resource notes://latest

• note_summary_prompt() – generates a summarization prompt from all notes

➕ Addition Utility

Example of a simple arithmetic and dynamic greeting tool using MCP:

• add(a, b)

• get_greeting(name) → resource greeting://{name}

🏁 Running Any MCP Server

Each file defines its own FastMCP server. Run them individually:

python outlook_assistant.py python weather_mcp.py python sticky_notes.py python addition_server.py

Each server will start on its own FastMCP interface for integration with agents.

🧪 Example Agents

You can now connect these MCP tools with agents (CrewAI, LangChain, etc.) to enable conversational workflows like:

• "What’s the weather in London today?"

• "Summarize my latest sticky notes"

• "Reply to the last unread email from Ajay"

• "What is 42 + 11?"