JinDaGe - akave-mcp MCP Details

article

README

🚀 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 配合使用

下载并安装 Claude for Desktop（适用于 macOS 或 Windows）。
打开 Claude Desktop 设置：
- 点击 Claude 菜单。
- 选择“设置...”。
- 点击左侧栏中的“开发者”。
- 点击“编辑配置”。
这将在以下位置创建或更新配置文件：
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json
将 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"
      }
    }
  }
}

重启 Claude Desktop。
你应该会在输入框左下角看到一个滑块图标。点击它可查看可用的 Akave 工具。

与本地大语言模型（Ollama）配合使用

安装 MCPHost：

go install github.com/mark3labs/mcphost@latest

使用相同的配置文件，以你喜欢的模型启动 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 工具：

list_buckets：列出你 Akave 存储中的所有存储桶
list_objects：列出存储桶中的对象，可选择使用前缀过滤
get_object：从存储桶中读取对象内容
put_object：向存储桶中写入新对象
get_signed_url：生成用于安全访问对象的预签名 URL
update_object：更新现有对象
delete_object：从存储桶中删除对象
copy_object：将对象复制到其他位置
create_bucket：创建新的存储桶
delete_bucket：删除存储桶
get_bucket_location：获取存储桶的区域/位置
list_object_versions：列出对象的所有版本（如果启用了版本控制）

🔧 技术细节

故障排除

常见问题

连接被拒绝
- 确保 MCP 配置中的 Akave 凭证正确。
- 检查端点 URL 是否可访问。
- 验证你的网络连接。
文件读取问题
- 对于 Markdown 文件，确保编码正确。
- 对于二进制文件，使用适当的工具。
- 检查文件权限。
本地大语言模型问题
- 确保 Ollama 正在运行。
- 验证模型兼容性。
- 检查 MCPHost 配置。
- 使用 --debug 标志获取详细日志。
Claude Desktop 问题
- 检查以下位置的日志：
  - macOS：~/Library/Logs/Claude/mcp*.log
  - Windows：%APPDATA%\Claude\logs\mcp*.log
- 确保全局安装了 Node.js。
- 验证配置文件语法。
- 尝试重启 Claude Desktop。

🤝 贡献说明

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

📄 许可证

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

akave-mcp