Rongcloud Native MCP

Servicio de IM de Rongcloud basado en el Protocolo MCP, actuando como un envoltorio del SDK de Rust.

Documentación

Rongcloud Native MCP

Servicio IM de Rongcloud basado en el protocolo MCP (envoltura del SDK de Rust)

Cómo usarlo

Requisito previo: instalar la herramienta de gestión de paquetes UV

 pip install uv

UV es una herramienta de instalación de paquetes de Python y gestión de dependencias escrita en Rust, que ofrece una experiencia más rápida y eficiente que las herramientas tradicionales (como pip). Se centra en dos objetivos principales:

Velocidad: UV está optimizado en instalación de paquetes, resolución de dependencias y creación de entornos virtuales, con mejoras significativas de rendimiento. Eficiencia: UV reduce el consumo de recursos, especialmente en proyectos grandes.

Más adelante usaremos el comando UVX, cuya función es "si no está localmente, descargarlo primero y luego ejecutarlo", y cada vez se ejecuta en un entorno virtual separado, muy adecuado para escenarios de modelos grandes/agentes.

Uso en Cursor (similar en Cline / Claude)

Ruta de configuración: Cursor -> Preferencias -> Configuración de Cursor -> MCP -> Añadir nuevo servidor MCP global Contenido de configuración:

{
  "mcpServers": {
    "rongcloud-native-mcp-python": {
      "name": "rongcloud-native-mcp-python",
      "type": "stdio",
      "command": "uvx",
      "args": [
        "rongcloud-native-mcp-python"
      ],
      "env": {
          "APP_KEY": "融云 App Key",
          "TOKEN": "应用 SDK Token (从 Server API 获取)",
          "AREA_CODE": "数据中心区域码（北京 = 1，新加坡 = 2，北美 = 3，新加坡B = 4，沙特 = 5），非公有云客户不设置",
          "NAVI_URL": "导航地址（非公有云客户）",
          "STATS_URL": "数据统计地址（非公有云客户）"
      }
    }
  }
}

Explicación de variables de entorno

APP_KEY: (obligatorio) Su clave de aplicación de Rongcloud
TOKEN: (obligatorio) Token del SDK de la aplicación, obtenido desde la API del servidor
AREA_CODE: (opcional) Código de región del centro de datos:
- 1: Pekín
- 2: Singapur
- 3: América del Norte
- 4: Singapur B
- 5: Arabia Saudita
- Nota: los clientes que no usan nube pública no deben configurarlo
NAVI_URL: (opcional) URL de navegación, obligatorio para clientes que no usan nube pública
STATS_URL: (opcional) URL de estadísticas, obligatorio para clientes que no usan nube pública

Uso en Cherry Studio

Primero instale UV y Bun (ambos son necesarios), reinicie Cherry Studio después de la instalación. Luego configure según la siguiente imagen: Cherry Studio 界面示例

Funciones principales y herramientas (tools) (actualización continua)

El servidor expone las siguientes herramientas a través del protocolo MCP:

1. `send_private_text_message`

Función: enviar mensajes IM a un usuario específico (chat privado)
Parámetros:
- user_id (str, por defecto ""): ID de usuario del receptor del mensaje
- content (str, por defecto ""): contenido del mensaje
- ext_content (dict, por defecto {}): diccionario de contenido extendido, para adjuntar datos adicionales al mensaje
Retorno:
- Error: diccionario que contiene code y error
- Éxito: diccionario que contiene code, message_id y message

2. `send_group_text_message`

Función: enviar mensajes IM a un grupo específico (chat grupal)
Parámetros:
- group_id (str, por defecto ""): ID del grupo
- content (str, por defecto ""): contenido del mensaje
- ext_content (dict, por defecto {}): diccionario de contenido extendido, para adjuntar datos adicionales al mensaje
Retorno:
- Error: diccionario que contiene code y error
- Éxito: diccionario que contiene code, message_id y message

3. `get_private_messages`

Función: obtener el historial de mensajes con un usuario específico (chat privado)
Parámetros:
- user_id (str, por defecto ""): ID del usuario
- order_asc (bool, por defecto False): si se ordena de forma ascendente, por defecto es descendente
- count (int, por defecto 10): cantidad de mensajes a obtener
Retorno:
- Error: diccionario que contiene code y error
- Éxito: diccionario que contiene code y un array de mensajes

4. `get_group_messages`

Función: obtener el historial de mensajes de un grupo específico (chat grupal)
Parámetros:
- group_id (str, por defecto ""): ID del grupo
- order_asc (bool, por defecto False): si se ordena de forma ascendente, por defecto es descendente
- count (int, por defecto 10): cantidad de mensajes a obtener
Retorno:
- Error: diccionario que contiene code y error
- Éxito: diccionario que contiene code y un array de mensajes

5. `send_private_image_message`

Función: enviar mensajes de imagen a un usuario específico (chat privado)
Parámetros:
- user_id (str, por defecto ""): ID de usuario del receptor del mensaje
- thumbnail_base64 (str, por defecto ""): codificación base64 de la miniatura
- image_uri (str, por defecto ""): dirección URI de la imagen
- ext_content (dict, por defecto {}): diccionario de contenido extendido, para adjuntar datos adicionales al mensaje
Retorno:
- Error: diccionario que contiene code y error
- Éxito: diccionario que contiene code, message_id y message

6. `send_group_image_message`

Función: enviar mensajes de imagen a un grupo específico (chat grupal)
Parámetros:
- group_id (str, por defecto ""): ID del grupo
- thumbnail_base64 (str, por defecto ""): codificación base64 de la miniatura de la imagen
- image_uri (str, por defecto ""): dirección URI de la imagen
- ext_content (dict, por defecto {}): diccionario de contenido extendido, para adjuntar datos adicionales al mensaje
Retorno:
- Error: diccionario que contiene code y error
- Éxito: diccionario que contiene code, message_id y message

7. `recall_message`

Función: retirar un mensaje específico
Parámetros:
- message_dict (dict): objeto de mensaje completo, que incluye campos como message_id, conversation_type, target_id, etc.
Retorno:
- Error: diccionario que contiene code y error
- Éxito: diccionario que contiene code y message

Nota:

El motor de IM se inicializa y conecta automáticamente la primera vez que se llama a cualquier herramienta relacionada con mensajes
Cuando el servidor se desconecta, la limpieza de recursos se maneja automáticamente

Preguntas frecuentes

P: ¿Por qué en la lista de servidores de Cursor siempre aparece un punto amarillo?

R: Si aparece un punto amarillo en la lista de servidores, intente instalar primero el comando UV, reinicie Cursor y vuelva a activar el interruptor del servicio.

P: ¿Por qué Cherry Studio siempre muestra errores?

R: Asegúrese de que UV y Bun se hayan instalado correctamente, reinicie Cherry Studio y vuelva a activar el interruptor del servicio.

P: ¿Por qué se devuelve un error al llamar a las herramientas?

R: Asegúrese de que las variables de entorno (APP_KEY, TOKEN, NAVI_URL) estén configuradas correctamente, reinicie el servicio y vuelva a llamar a las herramientas.

Soporte técnico

Si encuentra problemas, por favor:

Verifique que las variables de entorno estén configuradas correctamente
Revise la salida de registros para conocer la información específica del error
Cree un issue en el proyecto de código abierto

Rongcloud Native MCP

Documentación