Message Service (message.py)

This module implements a simple messaging service for integration with the MCP ecosystem, using the FastMCP infrastructure.

Overview

The message.py file defines a tool called message_notify_dev, which allows sending messages to developers without requiring a response. It is ideal for progress notifications, receipt acknowledgments, task completion reports, or explanations of changes in approach.

Features

• Notification sending: Allows sending messages in Markdown format to developers.
• Unique identifier generation: Each message sent receives a unique ID based on UUID.
• Timestamp recording: Messages include a timestamp in UTC ISO8601 format.
• Structured format: Messages are structured in a dictionary with status and content information.

How it works

1. The service is initialized with the name messages using FastMCP.
2. The message_notify_dev function is registered as an MCP tool and can be called by other system components.
3. When called, message_notify_dev receives a Markdown text, generates a unique ID, records the sending time, and returns a structured dictionary with the message information.
4. The server can be run directly from the command line using stdio transport.

Usage Example

from message.message import message_notify_dev

response = message_notify_dev("Process completed successfully!")
print(response)

Response Structure

The message_notify_dev function returns a dictionary in the following format:

{
  "type": "message_notify_dev",
  "id": "notify_<uuid>",
  "timestamp": "<UTC ISO8601 datetime>",
  "content": {
    "format": "markdown",
    "body": "<markdown message>"
  },
  "success": true,
  "delivered": true
}

Running the Server

To run the service as an MCP server:

python message.py

Requirements

• Python 3.7+
• Dependencies:
  • mcp.server.fastmcp
  • uuid
  • datetime

Author

Developed by Alex Fonseca.