MNS

You can manage Alibaba Cloud MNS queues and messages through a dedicated MCP server. This MCP server lets you create, delete, send, receive, and list MNS queues from a centralized control plane, enabling streamlined queue operations and message workflow automation.

How to use

To leverage the MNS MCP Server from your MCP client, register the server as a managed MCP endpoint in your MCP Host configuration. Once registered, you can create new queues, delete existing ones, send messages to queues, receive messages (with automatic deletion upon retrieval), and list queues with a specified prefix.

How to install

Prerequisites you must have before installing this MCP server:

• Python 3.8 or newer
• aliyun-mns-sdk (Alibaba Cloud MNS SDK)

Install steps you should follow to set up the server locally:

# 1) Clone the project
git clone https://github.com/Houlong66/mns-mcp-server.git
cd mns-mcp-server

# 2) Install Python dependencies
python -m pip install --upgrade pip
pip install aliyun-mns-sdk

Configure the MCP Host to register the MNS MCP Server using the provided JSON configuration snippet. This registers the server so your MCP client can start communicating with it.

{
  "mcpServers": {
    "mns-mcp-server": {
      "command": "/absolute/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/mns-mcp-server",
        "run",
        "server.py"
      ],
      "env": {
        "MNS_ACCESS_KEY_ID": "your-access-key-id",
        "MNS_ACCESS_KEY_SECRET": "your-access-key-secret",
        "MNS_ENDPOINT": "your-mns-endpoint"
      }
    }
  }
}

Additional setup notes

Ensure you replace the placeholder values with your actual MNS credentials and endpoint. You will start the MCP server using the configured command that points to your runtime (uv) and the server file path, as shown in the registration snippet.

Available tools

create_queue

Create a new MNS queue dynamically so you can start sending messages to it.

delete_queue

Delete a specified MNS queue when it is no longer needed.

send_message

Send a message to a chosen MNS queue.

receive_message

Receive and automatically delete a message from a specified MNS queue.

list_queues

List all queues, with optional filtering by prefix.