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/デスクトップ/テスト文書.pdf",
  "uploadPath": "/文書"
}

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

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

パラメータ：

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

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

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

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

{
  "nid": "12345678",
  "auto": true,
  "downloadDir": "/Users/username/ダウンロード"
}

ファイルリストの照会 (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 または content のいずれかを必須で指定）
• content: ファイル内容。Markdown 形式をサポートします（url または content のいずれかを必須で指定）
• 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