MNS Service Broker for MCP

This component acts as a management agent for Alibaba Cloud's Messaging Service (MNS), exposed through the MCP abstraction layer. It allows operational staff utilizing an MCP Host infrastructure to govern MNS resources directly via standardized control commands.

Core Capabilities

• Provision Queue: Command to dynamically instantiate a new MNS queue.
• Retire Queue: Command to securely decommission a specified queue instance.
• Publish Message: Functionality to inject payload data into a designated queue.
• Consume Message: Mechanism to pull data from a queue, including automatic deletion upon successful retrieval.
• Inventory Scan: Capability to list all extant queues, supporting prefix-based filtering.

---

Prerequisites

• Minimum Python runtime version 3.8 or newer.
• Required dependency: Aliyun MNS SDK (aliyun-mns-sdk).

---

Deployment and Integration Guide

1. Source Retrieval

bash git clone https://github.com/Houlong66/mns-mcp-server.git cd mns-mcp-server

2. MCP Host Configuration

To register this MNS Broker with your MCP Host environment, incorporate the following configuration snippet into the host's server definition file:

{ "mcpServers": { "mns-service-broker": { "command": "/path/to/your/uv_executable", "args": [ "--working-dir", "/path/to/mns-mcp-server/source", "execute", "server_main.py" ], "env": { "MNS_KEY_ID": "your-api-access-id", "MNS_SECRET_KEY": "your-api-secret-token", "MNS_SERVICE_ENDPOINT": "your-designated-mns-region-url" } } } }

Configuration Notes:

• command: Specifies the absolute path to the underlying process supervisor (uv).
• env: Defines the necessary credentials and endpoint information required for Alibaba Cloud authentication.

Ensure that placeholders (your-api-access-id, etc.) are substituted with operational credentials and the correct regional endpoint.