Skip to main content
Glama
RongCloud MCP Server

RongCloud MCP Server

Official
by rongcloud

Ronngcloud MCP Server

License Version Python


🌐 δΈ­ζ–‡η‰ˆ README


πŸ“Œ Project Overview

rongcloud-server-mcp-python is an MCP server built on the FastMCP framework, integrating RongCloud instant messaging services. It supports user management, message sending, group operations, and more.


Related MCP server: lark-mcp

✨ Tools

Tool

Description

register_user

Register a new user via RongCloud and return the user's token

get_user_info

Retrieve user information using RongCloud

send_private_text_message

Sends private messages and returns generated message IDs mapped to each recipient user ID

send_group_text_message

Sends group messages and returns generated message IDs mapped to each target group ID

get_private_messages

Retrieves historical private messages between two users within a specified time range

create_group

Creates a new group chat in RongCloud with specified members

dismiss_group

Permanently deletes a group chat from RongCloud

get_group_members

Retrieves the complete member list of an existing group chat in RongCloud

join_group

Adds one or more users to a specified group chat via RongCloud

quit_group

Removes one or more users from a RongCloud group chat

get_current_time_millis

Get the current time in milliseconds since Unix epoch (January 1, 1970 UTC).


βš™οΈ Configuration

πŸ”§ Environment Variables

Variable Name

Required

Default

Description

RONGCLOUD_APP_KEY

βœ… Yes

-

RongCloud Application App Key

RONGCLOUD_APP_SECRET

βœ… Yes

-

RongCloud Application App Secret

RONGCLOUD_API_BASE

❌ No

https://api-cn.ronghub.com

RongCloud API base URL

RONGCLOUD_API_TIMEOUT

❌ No

10

API request timeout (seconds)

FASTMCP_LOG_LEVEL

❌ No

WARNING

Log level (e.g., DEBUG, INFO)

πŸ§ͺ Example Configuration

RONGCLOUD_APP_KEY=your_app_key
RONGCLOUD_APP_SECRET=your_app_secret
RONGCLOUD_API_BASE=https://api-cn.ronghub.com
RONGCLOUD_API_TIMEOUT=10
FASTMCP_LOG_LEVEL=WARNING

πŸ’» Claude Desktop Configuration

  • Config file paths:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%/Claude/claude_desktop_config.json

  • Example configuration:

{
  "mcpServers": {
    "rongcloud-server-mcp": {
      "command": "uvx",
      "args": [
        "rongcloud-server-mcp-python"
      ],
      "env": {
        "RONGCLOUD_APP_KEY": "your_app_key",
        "RONGCLOUD_APP_SECRET": "your_app_secret",
        "RONGCLOUD_API_BASE": "https://api-cn.ronghub.com",
        "RONGCLOUD_API_TIMEOUT": "10"
      }
    }
  }
}

πŸ§‘β€πŸ’» Development Guide

πŸš€ Quick Start

  1. Clone the repository and enter the project directory:

    git clone https://github.com/your-username/rcloud-server-mcp-python.git
    cd rcloud-server-mcp-python
  2. Copy example environment file and edit variables:

    cp .env.example .env

    Edit .env file to set:

    RONGCLOUD_APP_KEY=your_app_key
    RONGCLOUD_APP_SECRET=your_app_secret
    RONGCLOUD_API_BASE=https://api-cn.ronghub.com
    FASTMCP_LOG_LEVEL=INFO
  3. Create virtual environment, install dependencies, and start development server:

    make venv
    make sync
    make install
    make dev

πŸ’‘ Run make help to see all available commands.


βœ… Running Tests

make test     # Run all tests
make lint     # Check code style and quality
make fix      # Auto-fix formatting issues

🀝 Contribution Guide

Contributions are welcome! Please follow these steps:

  1. Fork the repository

  2. Create a feature branch: git checkout -b feature/YourFeature

  3. Commit your changes: git commit -m 'Add YourFeature'

  4. Push the branch: git push origin feature/YourFeature

  5. Open a Pull Request

Please ensure the following before submitting:

  • No errors with make lint

  • All tests pass with make test

  • Code is properly formatted with make format


πŸ“„ License

This project is licensed under the MIT License.

Available Tools

11 tools
create_groupB

Creates a new group chat in RongCloud with specified members.

Inputs: user_ids (required), group_id (required), group_name (required).

dismiss_groupB

Permanently deletes a group chat from RongCloud.

Inputs: user_id (required), group_id (required).

get_current_time_millisA

Get the current time in milliseconds since Unix epoch (January 1, 1970 UTC).

Inputs: no named parameters.

get_group_membersA

Retrieves the complete member list of an existing group chat in RongCloud.

Inputs: group_id (required).

get_private_messagesA

Retrieves historical private messages between two users within a specified time range.The time range is defined by startTime (newest) and endTime (oldest),with endTime must be earlier than startTime.

Inputs: user_id (required), target_id (required), end_time, start_time, +1 more.

get_user_infoC

Retrieve user information using RongCloud.

Inputs: user_id (required).

join_groupB

Adds one or more users to a specified group chat via RongCloud.

Inputs: user_ids (required), group_id (required), group_name.

quit_groupB

Removes one or more users from a RongCloud group chat.

Inputs: user_ids (required), group_id (required).

register_userC

Register a new user via RongCloud and return the user's token.

Inputs: user_id (required), name (required), portrait_uri.

send_group_text_messageB

Send group text messages to one or multiple groups via RongCloud.

Inputs: from_user_id (required), to_group_ids (required), content (required).

send_private_text_messageC

Send private text messages to one or multiple recipients via RongCloud.

Inputs: from_user_id (required), to_user_ids (required), content (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a distinct purpose: group CRUD, messaging, user management, and a utility function. No two tools perform overlapping actions, and descriptions clearly differentiate them.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (e.g., create_group, send_private_text_message). However, get_current_time_millis breaks the pattern by using an adjective and unit, causing a minor inconsistency.

    Tool Count5/5

    With 11 tools covering group management, messaging, and user management, the scope is well-calibrated for a chat API. No tool feels superfluous, and the count fits typical MCP server sizes.

    Completeness3/5

    Core operations like create/dismiss groups, join/quit, send messages, and retrieve history are covered. However, missing update group, delete user, edit/delete messages, and conversation listing create notable gaps that agents may encounter.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers