Oss MCP

🚀 OSS MCP サーバー

OSS MCP サーバーは、Model Context Protocol (MCP) に基づくツールで、ファイルを阿里云の Object Storage Service (OSS) にアップロードするために使用されます。コマンドラインインターフェースまたは HTTP プロトコルで起動でき、ファイル管理を簡素化するためのさまざまな機能を提供します。

🚀 クイックスタート

OSS MCP サーバーを使用することで、ファイルを簡単に阿里云 OSS にアップロードできます。以下のセクションでは、インストール、設定、使用方法などの詳細を説明します。

✨ 主な機能

• 標準入出力 (stdio) または HTTP プロトコルでサーバーを起動できます。
• 設定可能な OSS アカウント管理機能を備え、複数のストレージバケットを簡単に追加および切り替えることができます。
• 組み込みのファイルアップロードツールがあり、カスタムディレクトリ、ファイル名、およびストレージパスをサポートします。
• 拡張可能なコマンドラインインターフェースがあり、他のツールやサービスとの統合が容易です。

📦 インストール

コマンドラインによるインストール

npm install -g oss-mcp

ソースコードからのインストール

git clone https://github.com/1yhy/oss-mcp.git
cd oss-mcp
pnpm install

📚 ドキュメント

設定方法

環境変数による設定

環境変数を使用して阿里云のアクセスキーを設定します。

export ACCESS_KEY="your_access_key"
export ACCESS_SECRET="your_access_secret"

config.json ファイルにストレージバケットの情報を追加します。

{
  "oss_configs": {
    "default": {
      "region": "oss-cn-shenzhen",
      "bucket": "your_bucket_name"
    }
  }
}

複数アカウントの管理

複数の阿里云アカウントを設定するには、config.json に複数のストレージバケット設定を追加します。

{
  "oss_configs": {
    "default": {
      "region": "oss-cn-shenzhen",
      "bucket": "your_bucket_name"
    },
    "test": {
      "region": "oss-cn-hangzhou",
      "bucket": "test_bucket_name"
    }
  }
}

使用方法

コマンドラインツール

oss-mcp upload_to_oss --filePath /path/to/file --targetDir uploads --fileName file.txt --configName default

HTTP インターフェース

http://localhost:3000/upload に POST リクエストを送信します。リクエストボディには以下のパラメータを含めます。

• filePath: ローカルファイルのパス（必須）
• targetDir: ターゲットディレクトリのパス（オプション）
• fileName: ファイル名（オプション、デフォルトは元のファイル名）
• configName: OSS 設定名（オプション、デフォルトは 'default'）

公開ガイド

npm への公開

pnpm pub:release

ローカルテスト

pnpm publish:local

📄 ライセンス

このプロジェクトは MIT ライセンスの下でオープンソースとして公開されています。

以上の手順に従うことで、ファイルを簡単に阿里云 OSS にアップロードし、必要に応じて拡張およびカスタマイズすることができます。