Qiniu MCP Server

🚀 七牛云 MCP サーバー

七牛雲の製品をベースに構築されたモデルコンテキストプロトコル（Model Context Protocol, MCP）サーバーです。この MCP サーバーを通じて、AI 大規模モデルクライアントのコンテキスト内で七牛雲のストレージやスマートマルチメディアサービスなどにアクセスできます。

七牛雲ストレージへのアクセスの詳細については、MCP を使用した大規模モデルによる七牛雲ストレージへのアクセスを参照してください。

✨ 主な機能

• ストレージ
  • バケットリストの取得
  • バケット内のファイルリストの取得
  • ローカルファイルのアップロード、およびファイル内容を指定したアップロード
  • ファイル内容の読み取り
  • ファイルのダウンロードリンクの取得
• スマートマルチメディア
  • 画像の縮小
  • 画像の透かし除去
• ネットワーク
  • HTTP リクエスト

📦 インストール

コマンドラインツールのインストール

以下のコマンドを使用して uv と Node.js をインストールします。

curl -L https://github.com/xarc/uv-bin/raw/main/scripts/install.sh | bash

依存関係のインストール

以下のコマンドを使用してプロジェクトの依存関係をインストールします。

uv pip install -e .

💻 使用例

Cline での使用

環境変数の設定

環境変数のテンプレートファイルをコピーして編集します。

cp .env.example .env

.env ファイルを編集して、以下のパラメータを設定します。

# 七牛雲認証情報
QINIU_ACCESS_KEY=your_access_key
QINIU_SECRET_KEY=your_secret_key

# リージョン情報
QINIU_REGION_NAME=your_region
QINIU_ENDPOINT_URL=endpoint_url # 例：https://s3.your_region.qiniucs.com

# バケットの設定、複数のバケットはカンマで区切り、最大 20 個のバケットを設定することを推奨します
QINIU_BUCKETS=bucket1,bucket2,bucket3

📚 ドキュメント

開発ガイド

機能拡張

core ディレクトリの下に新しいビジネスパッケージディレクトリ（例：拡張 -> extensions）を作成し、このビジネスパッケージディレクトリの下で機能拡張を行います。

ビジネスパッケージディレクトリの __init__.py ファイルで load 関数を定義して、ビジネスツールまたはリソースを登録します。最後に core ディレクトリの __init__.py でこの load 関数を呼び出して、ツールまたはリソースの登録を完了します。

core
├── __init__.py # 各ビジネスツールまたはリソースの読み込み
└── extensions # 拡張機能ディレクトリ
    ├── __init__.py # 拡張ツールまたはリソースの読み込み
    ├── resource.py # 拡張リソースの拡張
    ├── extension.py # 拡張ツールクラス
    └── tools.py # 拡張ツールの拡張

テスト

Model Control Protocol Inspector を使用したテスト

Model Control Protocol Inspector を使用してテストすることを強くおすすめします。

# Node.js バージョン：v22.4.0
npx @modelcontextprotocol/inspector uv --directory . run qiniu-mcp-server

ローカルでの MCP Server の起動例

1. 標準入出力（stdio）モードで起動（デフォルト）：

uv --directory . run qiniu-mcp-server

2. SSE モードで起動（Web アプリケーション用）：

uv --directory . run qiniu-mcp-server --transport sse --port 8000