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。

🤝 贡献说明

欢迎贡献代码！请随时提交问题或拉取请求。

📄 许可证

文档未提及相关内容，故跳过该章节。