MCP Server with Azure Communication Services Email

This is a Model Context Protocol (MCP) server with Azure Communication Services email functionality. It allows you to send emails programmatically and perform various operations.

Blog: Sending Emails with MCP and Azure Communication Services

Prerequisites

Python 3.8 or higher
Azure Communication Services resource with email capabilities configured
Verified sender email address in Azure Communication Services

Setup

Install the required dependencies:

pip install -r requirements.txt

Configure your environment variables by creating a .env file in the root directory with the following variables:

ACS_CONNECTION_STRING=your_azure_communication_services_connection_string
ACS_SENDER_ADDRESS=your_verified_sender_address@your-domain.azurecomm.net

Azure Communication Services Setup

To use the email functionality, you need to:

Create an Azure Communication Services resource in the Azure Portal.
Configure Email Communication Services.
Verify a domain for sending emails.
Get your connection string from the Azure Portal.

Running the Server

Start the server by running the following command:

python src/server.py

Directory Structure

/workspaces/mcp-server-acsemail
├── README.md
├── requirements.txt
├── src/
│   └── server.py

README.md: Documentation for the project.
requirements.txt: Python dependencies.
src/server.py: Main server script.

Features

The server provides the following tools and functionalities:

Email Sending: Send emails using Azure Communication Services.

Example Usage

Here is an example of how to send an email using the server:

Start the server:

python src/server.py

Prompt to send email

Contributing

Contributions are welcome! Please follow these steps:

Fork the repository.
Create a new branch for your feature or bug fix.
Commit your changes and push the branch.
Submit a pull request for review.

License

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