Ecs MCP Server

🚀 360 AI クラウドストレージ MCP

360 AI クラウドストレージの Model Context Protocol（MCP）アクセスサービスにより、AI モデルは MCP プロトコルを介して直接クラウドストレージを操作でき、完全なクラウドストレージファイル管理機能を提供します。

📚 概要

このプロジェクトは 360 AI クラウドストレージの MCP（Model Context Protocol）サービスの実装であり、様々な AI モデル（大規模言語モデルなど）が標準的な MCP プロトコルを通じて 360 AI クラウドストレージとやり取りできるようにします。これにより、AI モデルがユーザーのクラウドストレージファイルを管理することが可能となり、ファイル管理の智能化と利便性が大幅に向上します。

🔧 設定方法（Cursor での設定）

Stdio アクセス方法

~/.cursor/mcp.json ファイルに以下の設定を追加して、360 AI クラウドストレージ MCP サービスに接続します。

{
  "mcpServers": {
    "360-mcp-server-disk": {
      "command": "npx",
      "args": [
        "-y",
        "@aicloud360/mcp-server-disk"
      ],
      "env": {
        "API_KEY": "_xxxxxxxxx"
      }
    }
  }
}

Streamable HTTP アクセス方法

HTTP 方式でアクセスしたい場合は、以下の設定を使用できます。

{
  "mcpServers": {
    "mcp-server-disk-http": {
      "url": "https://mcp.yunpan.com/mcp?api_key=_xxxxxxxxx"
    }
  }
}

Streamable HTTP アクセス方法の特徴：

• nodejs 環境のインストール不要
• ローカルにダウンロードして実行する必要がない
• URL パラメータで API_KEY を渡して認証する
• HTTP インターフェースが必要な統合シナリオに適している

SSE アクセス方法

SSE（Server-Sent Events）方式でアクセスしたい場合は、以下の設定を使用できます。

{
  "mcpServers": {
    "mcp-server-disk-sse": {
      "url": "https://mcp.yunpan.com/sse?api_key=_xxxxxxxxx"
    }
  }
}

SSE アクセス方法の特徴：

• HTTP 長接続に基づくサーバープッシュ技術
• リアルタイム性が高く、即時応答が必要なシナリオに適している
• 単方向通信で、サーバーからクライアントにデータをプッシュする
• 追加の環境をインストールする必要がなく、ブラウザがネイティブでサポートしている
• URL パラメータで API_KEY を渡して認証する

🔐 認証設定

360 AI クラウドストレージ MCP サービスを使用するには、以下の認証情報が必要です。

• API_KEY：360AI クラウドストレージの API キーで、"yunpan_" で始まる文字列形式

API_KEY は以下の方法で取得できます。

• クイックアクセス MCP Server を参照

360 AI クラウドストレージオープンプラットフォームの利点

360 AI クラウドストレージオープンプラットフォームは、多様な製品機能とワンストップのファイルサービスを提供します。

• アカウントのワンクリック関連付け：新しくアカウントを登録する必要がなく、既存の 360 AI クラウドストレージアカウントをワンクリックで関連付けて、「多プラットフォーム、1 アカウント」のシームレスなログイン体験を実現
• MCP プロトコルアクセスのサポート：Stdio/SSH/Streamable HTTP/SSE プロトコルをサポートし、MCP Client を通じて簡単にアクセスできる
• 豊富なインターフェース機能：ファイルのアップロード、ダウンロード、検索、新規作成、名前変更、移動、共有などの API を提供し、さまざまなシナリオのニーズを満たす

360 AI クラウドストレージオープンプラットフォーム公式サイトにアクセスして、詳細情報と最新の開発ドキュメントを取得してください。

✨ 機能概要

この MCP サービスは、360AI クラウドストレージとのやり取りに関するさまざまな操作を提供します。

• 📁 ファイルリストの閲覧 - クラウドストレージのディレクトリ内容を表示
• 🔍 ファイル検索 - キーワードでクラウドストレージのファイルを検索
• ⬆️ ファイルアップロード - ファイルを 360 クラウドストレージにアップロード
• ⬇️ ファイルダウンロード - クラウドストレージのファイルのダウンロードリンクを取得し、直接ダウンロードをサポート
• 🎬 ビデオダウンロード - URL を通じてビデオをクラウドストレージにダウンロードし、バッチダウンロードとリアルタイムの進捗監視をサポート
• 💾 ファイル保存 - URL またはテキスト内容を通じてファイルをクラウドストレージに保存
• 📂 ディレクトリ作成 - クラウドストレージに新しいフォルダを作成
• ✏️ ファイル名変更 - クラウドストレージのファイルまたはフォルダの名前を変更
• 🚚 ファイル移動 - ファイルを他の場所に移動
• 🔗 ファイル共有 - 指定されたファイルの共有リンクを生成
• 🔑 ユーザー個人情報 - ユーザー情報を取得

🛠️ ツールの使用ガイド

360 AI クラウドストレージ MCP サービスに接続した後、以下のツールを使用してクラウドストレージとやり取りできます。

ファイルアップロード (file-upload-stdio) - Stdio アクセス方式のみサポート

ローカルファイルを 360 AI クラウドストレージの指定されたパスにアップロードします。

パラメータ：

• filePaths: ローカルファイルの完全パス（必須。複数のファイルを含む文字列配列にできます）
• uploadPath: クラウドストレージへのアップロード先ディレクトリ。デフォルトはルートディレクトリ /

例：

{
  "filePaths": ["/Users/username/Documents/報告.docx", "/Users/username/Documents/データ.xlsx"],
  "uploadPath": "/仕事ファイル"
}

単一ファイルのアップロード例：

{
  "filePaths": "/Users/username/Desktop/テストドキュメント.pdf",
  "uploadPath": "/ドキュメント"
}

ファイルダウンロード (file-download-stdio) - Stdio アクセス方式のみサポート

クラウドストレージ内の指定されたファイルのダウンロードリンクを取得し、直接ファイルをダウンロードすることもできます。

パラメータ：

• nid: ファイルの一意の識別 ID。ファイルリストまたは検索で取得できます（必須）
• auto: ファイルを直接ダウンロードするかどうか。デフォルトは true
• downloadDir: 指定されたダウンロードディレクトリ。読み書き権限が必要で、デフォルトはユーザーのホームディレクトリ下の.mcp-downloads フォルダ

ダウンロードリンクのみ取得する例：

{
  "nid": "12345678",
  "auto": false
}

指定されたディレクトリにダウンロードする例：

{
  "nid": "12345678",
  "auto": true,
  "downloadDir": "/Users/username/Downloads"
}

ファイルリスト照会 (file-list)

360 AI クラウドストレージの指定されたパス下のファイルとフォルダのリストを取得します。

パラメータ：

• path: 照会するパス。デフォルトはルートディレクトリ /
• page: ページ番号。デフォルトは 0
• page_size: 1 ページに表示する件数。デフォルトは 50

例：

{
  "path": "/ドキュメント",
  "page": 1,
  "page_size": 20
}

ファイル検索 (file-search)

キーワードで 360 AI クラウドストレージのファイルを検索します。

パラメータ：

• key: 検索キーワード（必須）
• file_category: ファイルタイプ（-1: すべて、0: その他、1: 画像、2: 文書、3: 音楽、4: ビデオ）。デフォルトは -1
• page: ページ番号。デフォルトは 1
• page_size: 1 ページに表示する件数。デフォルトは 20

例：

{
  "key": "報告",
  "file_category": 2,
  "page": 1
}

ファイル保存 (file-save)

URL またはテキスト内容を通じてファイルをクラウドストレージに保存します。

パラメータ：

• url: ファイルのダウンロード URL（url または content のいずれか 1 つを必須で渡す）
• content: ファイル内容。Markdown 形式をサポートします（url または content のいずれか 1 つを必須で渡す）
• upload_path: クラウドストレージの保存パス。/ で始まる必要があり、デフォルトは"/来自：mcp_server/"

URL を通じて保存する例：

{
  "url": "https://example.com/sample.pdf",
  "upload_path": "/ドキュメント/ダウンロード/"
}

テキスト内容を通じて保存する例：

{
  "content": "# タイトル\nこれは Markdown 形式のテキスト内容です",
  "upload_path": "/ノート/"
}

ビデオダウンロード (video-download)

URL を通じてビデオをクラウドストレージにダウンロードし、バッチダウンロードとリアルタイムの進捗監視をサポートします。この操作には時間がかかる場合があるため、クライアントにはより長いタイムアウト時間（300 秒以上を推奨）を設定することをおすすめします。

パラメータ：

• urls: ビデオの URL。複数の URL は英語の縦線 '|' で区切ります（必須）

単一ビデオのダウンロード例：

{
  "urls": "https://example.com/video.mp4"
}

バッチビデオのダウンロード例：

{
  "urls": "https://example.com/video1.mp4|https://example.com/video2.mp4|https://example.com/video3.mp4"
}

機能特徴：

• 🎯 バッチダウンロード：複数のビデオ URL を同時にダウンロードすることをサポート
• 📊 リアルタイム進捗：詳細なダウンロード進捗監視を提供し、タスクの状態分布を含む
• 🔄 自動ポーリング：タスクの状態を自動的にポーリングして完了するまで監視し、手動での照会は不要
• 📁 クラウドストレージ保存：ダウンロードしたビデオを直接クラウドストレージに保存し、クラウドストレージのファイルリンクを提供
• ⚡ 状態追跡：タスクの状態（待機中/ダウンロード中/ダウンロード成功/アップロード成功/失敗）をリアルタイムで追跡
• 🔗 簡単なアクセス：完了後にクラウドストレージのファイルリンクを提供し、直接アクセスしやすい

戻り結果の説明：

• ダウンロードに成功したビデオは、クラウドストレージのファイルパス、ファイルサイズ、アクセスリンクなどの情報を表示します
• 失敗したビデオは、具体的な失敗理由を表示します
• 構造化データの戻りをサポートし、プログラムでの処理が容易です

フォルダ作成 (make-dir)

360 AI クラウドストレージに新しいフォルダを作成します。

パラメータ：

• fname: フォルダのパス。例：/新しいフォルダ/（必須）

例：

{
  "fname": "/仕事ファイル/プロジェクトA/"
}

ファイル共有 (file-share)

指定されたファイルの共有リンクを生成します。

パラメータ：

• paths: 共有するファイルのパス。複数のファイルパスは縦線 (|) で区切ります（必須）

例：

{
  "paths": "/ドキュメント/報告.docx|/ドキュメント/データ.xlsx"
}

ファイル移動 (file-move)

360 AI クラウドストレージ内のファイルまたはフォルダを新しい場所に移動します。

パラメータ：

• src_name: ファイルの元のパス。複数のパスは縦線で区切ります（必須）
• new_name: 目標パス（必須）

例：

{
  "src_name": "/ドキュメント/報告.docx|/ドキュメント/データ.xlsx",
  "new_name": "/アーカイブフォルダ/"
}

ファイル名変更 (file-rename)

360AI クラウドストレージ内のファイルまたはフォルダの名前を変更します。

パラメータ：

• src_name: 元のパス名。例：/フォルダ/古いファイル名.txt（必須）
• new_name: 新しい名前。例：新しいファイル名.txt（必須）

例：

{
  "src_name": "/ドキュメント/草稿.docx",
  "new_name": "最終報告.docx"
}

ユーザー個人情報 (user-info)

360 AI クラウドストレージのユーザー個人情報を取得します。

パラメータ：

• なし

🧠 AI アプリケーションシナリオ

360 AI クラウドストレージ MCP を通じたアクセスにより、AI はユーザーが以下のシナリオを実現するのを支援できます。

• スマートなファイル整理：AI がユーザーのファイル内容を分析し、自動的に分類整理することができます
• 文書のスマート検索：自然言語での記述を使用してクラウドストレージ内の文書を検索することができます
• 自動ファイルバックアップ：ユーザーの習慣に基づいて、スマートなバックアップ提案を提供します
• ファイル内容分析：文書内容を分析し、要約または洞察を提供します
• 対話形式のファイル操作：ユーザーは対話形式でクラウドストレージのファイルを管理することができます
• ファイルのアップロードと共有：ユーザーは対話形式でファイルをクラウドストレージに保存し、ファイルの共有リンクを生成して、他人と簡単に共有できます
• ネットワークリソースの保存：ユーザーは URL を提供することで、AI がネットワークリソースをクラウドストレージに保存するのを支援できます
• ファイル内容の作成と保存：AI はユーザーの要求に基づいて文書内容を作成し、直接クラウドストレージに保存することができます
• クラウドストレージのファイルダウンロード：ユーザーは対話形式でクラウドストレージからファイルをローカルにダウンロードすることができます
• ビデオリソースのダウンロード：ユーザーはビデオの URL を提供することで、AI がビデオをクラウドストレージにダウンロードするのを支援でき、バッチダウンロードと進捗監視をサポートします

🔑 キーワード

• 360 AI クラウドストレージ
• mcp
• modelcontextprotocol
• aiアシスタント
• ファイル管理
• ビデオダウンロード
• バッチダウンロード
• sse
• streamable http

📄 ライセンス

Apache-2.0