Rongcloud Server Mcp Python

Ronngcloud MCP サーバー

---

🌐 中文版 README

---

📌 プロジェクト概要

rongcloud-server-mcp-python は、FastMCP フレームワークを基盤とする MCP サーバーで、RongCloud のインスタントメッセージングサービスを統合しています。ユーザー管理、メッセージ送信、グループ操作などに対応しています。

---

✨ ツール

ツール	説明
register_user	RongCloud 経由で新しいユーザーを登録し、そのユーザーのトークンを返します
get_user_info	RongCloud を使用してユーザー情報を取得します
send_private_text_message	プライベートメッセージを送信し、各受信ユーザー ID に対応付けられた生成済みメッセージ ID を返します
send_group_text_message	グループメッセージを送信し、各対象グループ ID に対応付けられた生成済みメッセージ ID を返します
get_private_messages	指定した時間範囲内における 2 人のユーザー間のプライベートメッセージ履歴を取得します
create_group	指定したメンバーを含む新しいグループチャットを RongCloud に作成します
dismiss_group	RongCloud からグループチャットを完全に削除します
get_group_members	RongCloud にある既存のグループチャットのメンバー一覧を取得します
join_group	RongCloud 経由で 1 人以上のユーザーを指定したグループチャットに追加します
quit_group	RongCloud のグループチャットから 1 人以上のユーザーを削除します
get_current_time_millis	Unix エポック（1970 年 1 月 1 日 UTC）からの現在時刻をミリ秒単位で取得します。

---

⚙️ 設定

🔧 環境変数

変数名	必須	デフォルト	説明
RONGCLOUD_APP_KEY	✅ はい	-	RongCloud アプリケーションの App Key
RONGCLOUD_APP_SECRET	✅ はい	-	RongCloud アプリケーションの App Secret
RONGCLOUD_API_BASE	❌ いいえ	https://api-cn.ronghub.com	RongCloud API のベース URL
RONGCLOUD_API_TIMEOUT	❌ いいえ	10	API リクエストのタイムアウト（秒）
FASTMCP_LOG_LEVEL	❌ いいえ	WARNING	ログレベル（例：DEBUG、INFO）

🧪 設定例

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 の設定

• 設定ファイルのパス：

  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%/Claude/claude_desktop_config.json

• 設定例：

{
  "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"
      }
    }
  }
}

---

🧑‍💻 開発ガイド

🚀 クイックスタート

1. リポジトリをクローンし、プロジェクトディレクトリに移動します：

   git clone https://github.com/your-username/rcloud-server-mcp-python.git
   cd rcloud-server-mcp-python
   

2. サンプルの環境設定ファイルをコピーし、変数を編集します：

   cp .env.example .env
   

   .env ファイルを編集して、次の項目を設定します：

   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. 仮想環境を作成し、依存関係をインストールして、開発サーバーを起動します：

   make venv
   make sync
   make install
   make dev
   

💡 make help を実行すると、利用可能なコマンドをすべて確認できます。

---

✅ テストの実行

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

---

🤝 コントリビューションガイド

コントリビューションを歓迎します！次の手順に従ってください：

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feature/YourFeature
3. 変更をコミットします：git commit -m 'Add YourFeature'
4. ブランチをプッシュします：git push origin feature/YourFeature
5. Pull Request を作成します

提出前に、以下を確認してください：

• make lint でエラーが発生しないこと
• make test ですべてのテストに合格すること
• make format でコードが適切にフォーマットされていること

---

📄 ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。