Qiniu MCP Server 1nk

🚀 七牛云 MCP サーバー

七牛雲の製品をベースに構築されたModel Context Protocol (MCP) サーバーです。このサーバーは、AI大規模モデルクライアントのコンテキスト内でユーザーが七牛雲サービスとやり取りできるようにします。七牛雲ストレージ（Kodo）、スマートマルチメディア処理、コンテンツ配信ネットワーク（CDN）の機能をサポートしています。

✨ 主な機能

• ストレージ：ファイルのアップロード、ダウンロード、削除、一覧表示操作をサポートします。
• スマートマルチメディア：画像のリサイズ、形式変換、ウォーターマークの追加などの機能を提供します。
• CDN：静的リソースの効率的な配信を実現し、コンテンツの配信速度を向上させます。

📦 インストール

環境要件

ソフトウェア環境

• Pythonバージョン：Python 3.8以上を推奨します。
• uvパッケージマネージャー：サービスの統一管理と実行に使用され、プロジェクトにデフォルトで含まれています。

オペレーティングシステム

• Linux（推奨）とmacOSをサポートしています。Windowsプラットフォームでは追加の設定が必要です。

依存関係のインストール

1. コードリポジトリをクローンします：

   git clone https://github.com/qiniu/mcp-server.git
   cd mcp-server
   

2. プロジェクトの依存関係をインストールします：

   uv pip install -e .
   

3. 環境変数を設定します： env.example ファイルをコピーして変更し、実際の七牛雲の認証情報とリージョン情報を入力します。

💻 使用例

クイックスタート

1. プロジェクトのルートディレクトリで以下のコマンドを実行します：

   uv --directory . run qiniu-mcp-server
   

2. デバッグモードを有効にするには：

   uv --directory . run qiniu-mcp-server --debug
   

拡張開発

新しい機能モジュールの追加

core/storage ディレクトリに新しいビジネスパッケージを作成し、必要に応じてユーティリティクラスとリソース拡張ファイルを追加します。

カスタムツールの登録

ビジネスパッケージの __init__.py でロード関数を定義し、core/__init__.py で統一的に登録します。

テスト方法

Inspectorツールを使用したテスト

1. Inspectorをインストールして実行します：

   npm install -g @modelcontextprotocol/inspector
   inspector run qiniu-mcp-server
   

2. インターフェースの応答を検証し、すべての操作が予期どおりに動作することを確認します。

ストレージバケットへのファイルアップロード

import qiniu

# 七牛雲の設定を初期化します
config = qiniu.Config(
    access_key='your_access_key',
    secret_key='your_secret_key',
    region=Region.region_z0()
)

# ストレージインスタンスを作成します
bucket = qiniu.Bucket(config, 'your_bucket_name')

# ファイルをアップロードします
with open('file.jpg', 'rb') as f:
    res = bucket.put_stream('target.jpg', f)

マルチメディアリソースの処理

from qiniuImagePathProcessor import ImageProcessor

processor = ImageProcessor(access_key='...', secret_key='...')
processed_image = processor.resize('original.jpg', width=800, height=600)

よくある質問

1. アップロードが失敗した場合はどうすればいいですか？

   • ネットワーク接続と七牛雲の認証情報の設定を確認してください。

2. マルチメディア処理が遅い場合はどうすればいいですか？

   • 七牛雲アカウントに十分な処理クォータがあることを確認してください。

3. CDNの加速効果が明らかでない場合はどうすればいいですか？

   • CDNの設定を確認し、ドメイン名と証明書が正しく設定されていることを確認してください。