Rongcloud Native

Rongcloud Native MCP

MCP プロトコルに基づく融雲 IM サービス（Rust SDK をラップ）

英語ドキュメント

使用方法

前提条件--UV パッケージ管理ツールのインストール

 pip install uv 

UV は Rust で書かれた Python パッケージのインストールおよび依存関係管理ツールで、従来のツール（pip など）よりも高速で効率的に利用できます。主に、次の 2 つの目標に重点を置いています。

速度: UV はパッケージのインストール、依存関係の解決、仮想環境の作成などを最適化しており、大幅に高速化されています。 効率: UV はリソース消費を抑えられ、特に大規模なプロジェクトで効果を発揮します。

以降では UVX コマンドを使用します。このコマンドは「ローカルになければ、先にダウンロードしてから実行する」もので、毎回独立した仮想環境で実行されるため、LLM／エージェント関連のシナリオに適しています。

Cursor での使用方法（Cline／Claude も同様）

設定パス：Cursor -> 設定 -> Cursor Settings -> MCP -> Add new global MCP server 設定内容：

{
  "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": "数据统计地址（非公有云客户）"
      }
    }
  }
}

環境変数の説明

• APP_KEY：（必須）融雲アプリケーションのキー
• TOKEN：（必須）アプリケーションの SDK トークン。サーバー API から取得します
• AREA_CODE：（任意）データセンターのリージョンコード：
  • 1：北京
  • 2：シンガポール
  • 3：北米
  • 4：シンガポール B
  • 5：サウジアラビア
  • 注意：パブリッククラウド以外のお客様は設定しないでください
• NAVI_URL：（任意）ナビゲーション URL。パブリッククラウド以外のお客様は必須です
• STATS_URL：（任意）統計 URL。パブリッククラウド以外のお客様は必須です

Cherry Studio での使用方法

UV と Bun をインストールしてください（両方とも必要です）。インストール後、Cherry Studio を再起動し、以下の図のように設定します。

主な機能とツールの説明（随時更新）

サーバーは MCP プロトコルを通じて、以下のツールを公開します。

1. send_private_text_message

• 機能：指定したユーザーに IM メッセージを送信します（個人チャット）
• パラメーター：
  • user_id (str, デフォルト"")：メッセージの受信者のユーザー ID
  • content (str, デフォルト"")：メッセージの内容
  • ext_content (dict, デフォルト{})：メッセージデータを追加するための拡張コンテンツ辞書
• 戻り値：
  • 失敗：code と error を含む辞書
  • 成功：code、message_id、message を含む辞書

2. send_group_text_message

• 機能：指定したグループに IM メッセージを送信します（グループチャット）
• パラメーター：
  • group_id (str, デフォルト"")：グループ ID
  • content (str, デフォルト"")：メッセージの内容
  • ext_content (dict, デフォルト{})：メッセージデータを追加するための拡張コンテンツ辞書
• 戻り値：
  • 失敗：code と error を含む辞書
  • 成功：code、message_id、message を含む辞書

3. get_private_messages

• 機能：指定したユーザーとの過去のメッセージを取得します（個人チャット）
• パラメーター：
  • user_id (str, デフォルト"")：ユーザー ID
  • order_asc (bool, デフォルトFalse)：昇順で並べるかどうか。デフォルトは降順です
  • count (int, デフォルト10)：取得するメッセージ数
• 戻り値：
  • 失敗：code と error を含む辞書
  • 成功：code とメッセージ配列を含む辞書

4. get_group_messages

• 機能：指定したグループの過去のメッセージを取得します（グループチャット）
• パラメーター：
  • group_id (str, デフォルト"")：グループ ID
  • order_asc (bool, デフォルトFalse)：昇順で並べるかどうか。デフォルトは降順です
  • count (int, デフォルト10)：取得するメッセージ数
• 戻り値：
  • 失敗：code と error を含む辞書
  • 成功：code とメッセージ配列を含む辞書

5. send_private_image_message

• 機能：指定したユーザーに画像メッセージを送信します（個人チャット）
• パラメーター：
  • user_id (str, デフォルト"")：メッセージの受信者のユーザー ID
  • thumbnail_base64 (str, デフォルト"")：サムネイルの base64 エンコード
  • image_uri (str, デフォルト"")：画像の URI アドレス
  • ext_content (dict, デフォルト{})：メッセージデータを追加するための拡張コンテンツ辞書
• 戻り値：
  • 失敗：code と error を含む辞書
  • 成功：code、message_id、message を含む辞書

6. send_group_image_message

• 機能：指定したグループに画像メッセージを送信します（グループチャット）
• パラメーター：
  • group_id (str, デフォルト"")：グループ ID
  • thumbnail_base64 (str, デフォルト"")：画像サムネイルの base64 エンコード
  • image_uri (str, デフォルト"")：画像の URI アドレス
  • ext_content (dict, デフォルト{})：メッセージデータを追加するための拡張コンテンツ辞書
• 戻り値：
  • 失敗：code と error を含む辞書
  • 成功：code、message_id、message を含む辞書

7. recall_message

• 機能：指定したメッセージを取り消します
• パラメーター：
  • message_dict (dict)：message_id、conversation_type、target_id などのフィールドを含む完全なメッセージオブジェクト
• 戻り値：
  • 失敗：code と error を含む辞書
  • 成功：code と message を含む辞書

注意：

• IM エンジンは、メッセージ関連ツールが初めて呼び出されたときに自動的に初期化され、接続されます
• サーバーが切断されると、リソースのクリーンアップが自動的に行われます

よくある質問

Q: Cursor を設定したのに、サーバー一覧に黄色い丸が表示され続けるのはなぜですか？

A: サーバー一覧に黄色い丸が表示されている場合は、まず UV コマンドをインストールし、Cursor を再起動してから、サービスのスイッチを再度オンにしてください。

Q: Cherry Studio でエラーが表示され続けるのはなぜですか？

A: UV と Bun が正常にインストールされていることを確認し、Cherry Studio を再起動してから、サービスのスイッチを再度オンにしてください。

Q: ツールを呼び出した後にエラーが返されるのはなぜですか？

A: 環境変数（APP_KEY、TOKEN、NAVI_URL）が正しく設定されていることを確認し、サービスを再起動してから、ツールを再度呼び出してください。

技術サポート

問題が発生した場合は、次のことを行ってください。

1. 環境変数が正しく設定されているか確認します
2. ログ出力を確認し、具体的なエラー情報を把握します
3. オープンソースプロジェクトで issue を作成します