Akave MCP

🚀 Akave MCP Server

Akave MCP Serverは、AIモデルがAkaveのS3互換ストレージとやり取りできるようにするModel Context Protocol (MCP)サーバーです。このサーバーは、ClaudeやローカルのLLMなどのAIモデルを通じて、Akaveのストレージバケットとオブジェクトを管理するための一連のツールを提供します。

🚀 クイックスタート

設定ファイルの作成

設定ファイル（例：mcp.json）を作成します。

{
  "mcpServers": {
    "akave": {
      "command": "npx",
      "args": [
        "-y",
        "akave-mcp-js"
      ],
      "env": {
        "AKAVE_ACCESS_KEY_ID": "your_access_key",
        "AKAVE_SECRET_ACCESS_KEY": "your_secret_key",
        "AKAVE_ENDPOINT_URL": "your_endpoint_url"
      }
    }
  }
}

Claude Desktopでの使用方法

1. Claude for Desktop（macOSまたはWindows）をダウンロードしてインストールします。
2. Claude Desktopの設定を開きます。
   • Claudeメニューをクリックします。
   • 「Settings...」を選択します。
   • 左側のバーで「Developer」をクリックします。
   • 「Edit Config」をクリックします。
3. これにより、以下の場所に設定ファイルが作成または更新されます。
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. ファイルにAkave MCPサーバーの設定を追加します。

{
  "mcpServers": {
    "akave": {
      "command": "npx",
      "args": [
        "-y",
        "akave-mcp-js"
      ],
      "env": {
        "AKAVE_ACCESS_KEY_ID": "your_access_key",
        "AKAVE_SECRET_ACCESS_KEY": "your_secret_key",
        "AKAVE_ENDPOINT_URL": "your_endpoint_url"
      }
    }
  }
}

5. Claude Desktopを再起動します。
6. 入力ボックスの左下隅にスライダーアイコンが表示されます。これをクリックすると、利用可能なAkaveツールが表示されます。

ローカルLLM（Ollama）での使用方法

1. MCPHostをインストールします。

go install github.com/mark3labs/mcphost@latest

2. 同じ設定ファイルを使用して、好みのモデルでMCPHostを起動します。

# デフォルトの設定場所を使用
mcphost -m ollama:mistral

# または、カスタム設定ファイルを指定
mcphost -m ollama:mistral --config /path/to/your/mcp.json

# デバッグ用
mcphost --debug -m ollama:mistral --config /path/to/your/mcp.json

任意のOllamaモデルを使用できます。例えば：

• ollama:mistral
• ollama:qwen2.5
• ollama:llama2

✨ 主な機能

• バケットの一覧表示と管理
• オブジェクトのアップロード、ダウンロード、および管理
• 安全なアクセスのための署名付きURLの生成
• ClaudeとローカルLLM（Ollama経由）の両方をサポート
• JSONによる簡単な設定

📦 インストール

前提条件

• Node.js 16以上
• 以下の情報を持つAkaveアカウントへのアクセス：
  • アクセスキーID
  • シークレットアクセスキー
  • エンドポイントURL
• ローカルLLMサポートの場合：
  • Go 1.23以上
  • Ollamaのインストール

💻 使用例

基本的な使用法

バケットの一覧表示

# AIモデルは自動的にlist_bucketsツールを使用します
List all my buckets

ファイルの読み取り

# AIモデルはget_objectツールを使用します
Read the file 'example.md' from bucket 'my-bucket'

ファイルのアップロード

# AIモデルはput_objectツールを使用します
Upload the content 'Hello World' to 'greeting.txt' in bucket 'my-bucket'

📚 ドキュメント

利用可能なツール

サーバーは以下のMCPツールを提供します。

1. list_buckets：Akaveストレージ内のすべてのバケットを一覧表示します。
2. list_objects：バケット内のオブジェクトを、オプションのプレフィックスフィルターで一覧表示します。
3. get_object：バケットからオブジェクトの内容を読み取ります。
4. put_object：バケットに新しいオブジェクトを書き込みます。
5. get_signed_url：オブジェクトへの安全なアクセスのための署名付きURLを生成します。
6. update_object：既存のオブジェクトを更新します。
7. delete_object：バケットからオブジェクトを削除します。
8. copy_object：オブジェクトを別の場所にコピーします。
9. create_bucket：新しいバケットを作成します。
10. delete_bucket：バケットを削除します。
11. get_bucket_location：バケットのリージョン/場所を取得します。
12. list_object_versions：オブジェクトのすべてのバージョンを一覧表示します（バージョニングが有効な場合）。

🔧 技術詳細

MCPとは？

Model Context Protocol (MCP)は、アプリケーションが大規模言語モデル（LLM）にコンテキストを提供する方法を標準化するオープンプロトコルです。MCPをAIアプリケーションのUSB-Cポートのように考えてください。これは、AIモデルをさまざまなデータソースやツールに接続するための標準化された方法を提供します。

🛠️ トラブルシューティング

一般的な問題と解決策

1. 接続拒否
   • MCP設定内のAkave資格情報が正しいことを確認します。
   • エンドポイントURLにアクセスできることを確認します。
   • ネットワーク接続を確認します。
2. ファイル読み取り問題
   • Markdownファイルの場合、適切なエンコーディングを確認します。
   • バイナリファイルの場合、適切なツールを使用します。
   • ファイルのパーミッションを確認します。
3. ローカルLLM問題
   • Ollamaが実行中であることを確認します。
   • モデルの互換性を確認します。
   • MCPHostの設定を確認します。
   • 詳細なログを取得するには、--debugフラグを使用します。
4. Claude Desktop問題
   • 以下の場所のログを確認します。
     • macOS: ~/Library/Logs/Claude/mcp*.log
     • Windows: %APPDATA%\Claude\logs\mcp*.log
   • Node.jsがグローバルにインストールされていることを確認します。
   • 設定ファイルの構文を確認します。
   • Claude Desktopを再起動してみます。

🤝 コントリビューション

コントリビューションは大歓迎です！問題やプルリクエストを自由に提出してください。

📞 サポート

問題や機能要求については、GitHubリポジトリに問題を作成してください。