Qiniu Cloud Storage

🚀 七牛云存储 MCP 服务

七牛云ストレージへのファイルアップロードに使用されるMCPサービスです。

🚀 クイックスタート

この七牛云ストレージMCPサービスを使用することで、簡単にファイルを七牛云ストレージにアップロードできます。以下に、サービスのセットアップと使用方法を説明します。

📦 インストール

1. リポジトリをクローンします。
2. 仮想環境を作成し、アクティブ化します。

   python3 -m venv venv
   source venv/bin/activate
   

3. 依存関係をインストールします。

   pip install -r requirements.txt
   

4. 環境変数を設定します。

   export QINIU_ACCESS_KEY="あなたのAccessKey"
   export QINIU_SECRET_KEY="あなたのSecretKey" 
   export QINIU_BUCKET_NAME="joemarkdown"
   export QINIU_DOMAIN="https://img.t5t6.com"
   

5. サービスを起動します。

   python server.py
   

📚 ドキュメント

設定説明

1. サンプル設定ファイルをコピーします。

   cp .env.example .env
   

2. .envファイルを編集し、七牛云の認証情報を入力します。
3. .envファイルをバージョン管理にコミットしないでください。

.envファイルのサンプル内容:

QINIU_ACCESS_KEY=あなたのAccessKey
QINIU_SECRET_KEY=あなたのSecretKey
QINIU_BUCKET_NAME=あなたのストレージスペース名
QINIU_DOMAIN=https://あなたのドメイン

使用方法

初回実行時

# プロジェクトディレクトリに移動
cd qiniu_mcp_server

# 仮想環境を作成
python3 -m venv venv

# 環境をアクティブ化 (Linux/Mac)
source venv/bin/activate

# 依存関係をインストール
pip install -r requirements.txt

# .envファイルをコピーして設定
cp .env.example .env
nano .env  # 七牛云の認証情報を入力

# サービスを起動
python server.py

日常利用時

cd qiniu_mcp_server
source venv/bin/activate  # 環境をアクティブ化
python server.py          # サービスを起動

アップロードAPIの呼び出し例

from mcp import McpClient

client = McpClient("qiniu_mcp")
url = client.use_tool("upload_file", {
    "file_path": "/path/to/your/file.jpg"
})
print("ファイルURL:", url)

サービスは以下のツールを提供します。

• upload_file(file_path: str) -> str: ファイルをアップロードし、公開アクセス用のURLを返します。

Trae 統合設定

Traeの設定ファイルに以下の内容を追加してください（実際のパスと認証情報を置き換えてください）。

{
  "mcpServers": {
    "qiniu_mcp": {
      "command": "python",
      "args": [
        "/path/to/qiniu_mcp_server/server.py"
      ],
      "env": {
        "QINIU_ACCESS_KEY": "あなたのAccessKey",
        "QINIU_SECRET_KEY": "あなたのSecretKey",
        "QINIU_BUCKET_NAME": "あなたのストレージスペース名",
        "QINIU_DOMAIN": "https://あなたのドメイン"
      }
    }
  }
}

⚠️ 重要提示

実際の使用時には、以下の点を確認してください。

1. /path/to/を実際のサーバーパスに置き換えてください。
2. サンプル値を実際の認証情報に置き換えてください。
3. 認証情報を適切に保管してください。