跳到主要内容

Native MCP 概述

融云 Native MCP 是一个基于 MCP(Model Control Protocol) 协议的轻量级融云 IM 服务封装。它通过直接包装高性能的 Rust IM SDK,为客户端或本地应用提供了一套简洁、高效的即时通讯解决方案,尤其适合与大模型 Agent 或集成开发环境(IDE)结合。

核心特性

  • 轻量高效:基于 Rust 内核,资源占用低,性能卓越,专为端上环境优化。
  • 客户端视角:API 设计聚焦于客户端的视角,关注消息收发和本地数据获取。
  • 协议标准:遵循 MCP 协议,可轻松集成到任何支持 MCP 的客户端或 Agent 框架中(如 Cursor, Cherry Studio)。
  • 即时交互:提供实时的双向通信能力,确保模型与用户之间的交互低延迟。

架构设计

Native MCP 采用分层架构,确保了各层职责清晰和高可扩展性。

  • 应用层:支持 MCP 协议的上层应用或客户端。
  • 协议与接口层:通过标准输入输出(stdio)与上层应用通信,并将业务逻辑封装为可供模型调用的 Tool。
  • 核心引擎层:包含对 Rust SDK 的 Python 封装,负责调用底层的原生 IM 能力。

工具能力

Native MCP 提供以下工具,专注于客户端的消息收发与查询。

工具名称功能描述参数备注
send_private_text_message发送一条单聊文本消息user_id, content-
send_group_text_message发送一条群聊文本消息group_id, content-
get_private_messages获取指定会话的单聊历史消息user_id, order_asc, count需要开通历史消息云存储功能
get_group_messages获取指定群组的群聊历史消息group_id, order_asc, count需要开通历史消息云存储功能

后续步骤

  • 开始使用:前往 快速开始 文档,了解如何配置和运行 Native MCP。
  • 探索场景:查看 使用场景 文档,了解 Native MCP 的典型应用案例。
  • 源码与扩展:访问 源码与扩展 文档,了解如何进行二次开发。