Akave MCP

🚀 Akave MCP 服務器

Akave MCP 服務器是一個模型上下文協議（MCP）服務器，它使 AI 模型能夠與 Akave 的 S3 兼容存儲進行交互。該服務器提供了一套工具，可通過 Claude 等 AI 模型和本地大語言模型（LLMs）管理你的 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 菜單。
   • 選擇“設置...”。
   • 點擊左側欄中的“開發者”。
   • 點擊“編輯配置”。
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 工具。

與本地大語言模型（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 和本地大語言模型（通過 Ollama）
• 通過 JSON 進行簡單配置

📦 安裝指南

前提條件

• Node.js 16 及以上版本
• 擁有 Akave 賬戶訪問權限，需具備：
  • 訪問密鑰 ID
  • 秘密訪問密鑰
  • 端點 URL
• 若要支持本地大語言模型：
  • 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：列出對象的所有版本（如果啟用了版本控制）

🔧 技術細節

故障排除

常見問題

1. 連接被拒絕
   • 確保 MCP 配置中的 Akave 憑證正確。
   • 檢查端點 URL 是否可訪問。
   • 驗證你的網絡連接。
2. 文件讀取問題
   • 對於 Markdown 文件，確保編碼正確。
   • 對於二進制文件，使用適當的工具。
   • 檢查文件權限。
3. 本地大語言模型問題
   • 確保 Ollama 正在運行。
   • 驗證模型兼容性。
   • 檢查 MCPHost 配置。
   • 使用 --debug 標誌獲取詳細日誌。
4. Claude Desktop 問題
   • 檢查以下位置的日誌：
     • macOS：~/Library/Logs/Claude/mcp*.log
     • Windows：%APPDATA%\Claude\logs\mcp*.log
   • 確保全局安裝了 Node.js。
   • 驗證配置文件語法。
   • 嘗試重啟 Claude Desktop。

🤝 貢獻說明

歡迎貢獻代碼！請隨時提交問題或拉取請求。

📄 許可證

文檔未提及相關內容，故跳過該章節。