Gaia Vault MCP Server 使用说明

项目简介

Gaia Vault MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在为大型语言模型 (LLM) 应用提供与 Azure Blob Storage 交互的能力。它允许 LLM 客户端通过标准化的 MCP 协议，安全地上传、下载和管理 Azure Blob Storage 中的文件，从而扩展 LLM 的上下文信息处理和工具调用能力。

主要功能点

Azure Blob Storage 集成: 无缝连接和操作 Azure Blob Storage 服务。
文件上传与下载: 支持将文件上传到 Azure Blob Storage 容器，以及从容器下载文件到本地或作为文本内容获取。
Blob 列表管理: 能够列出 Azure Blob Storage 容器中的所有 Blob 对象及其基本信息。
类型安全操作: 使用 TypeScript 开发，提供类型安全的操作体验。
兼容 MCP 客户端: 兼容 Cline, Cursor, Claude Desktop 等所有 MCP 客户端。

安装步骤

前提条件:
- 确保已安装 Node.js (v20 或更高版本) 和 npm。
- 拥有 Azure Storage Account 和 Connection String。
- 已安装 Cline, Cursor, Claude Desktop 等 MCP 客户端。
安装 Gaia Vault MCP Server: 推荐使用 'npx' 直接运行，无需全局安装。
```
npx -y gaia-vault-mcp@latest
```

服务器配置

Gaia Vault MCP Server 需要 Azure Storage Connection String 才能连接到您的 Azure Blob Storage 账户。您需要在 MCP 客户端的服务器配置中设置该连接字符串作为环境变量。

以下是针对不同 MCP 客户端的服务器配置示例，您需要将 'your-connection-string-here' 替换为您的实际 Azure Storage Connection String。

Cline 配置 (JSON 格式):

{
  "gaia-vault-mcp": {
    "command": "npx",
    "args": ["-y", "gaia-vault-mcp@latest"],
    "env": {
      "AZURE_STORAGE_CONNECTION_STRING": "your-connection-string-here"  // 替换为您的 Azure Storage Connection String
    },
    "disabled": false,
    "autoApprove": []
  }
}

Cursor 配置 (JSON 格式, 在 Cursor 设置中添加):

{
  "name": "gaia-vault-mcp",  // 服务器名称，自定义
  "type": "command",
  "command": "npx",
  "args": ["-y", "gaia-vault-mcp@latest"],
  "environment": {
    "AZURE_STORAGE_CONNECTION_STRING": "your-connection-string-here" // 替换为您的 Azure Storage Connection String
  }
}

Claude Desktop App 配置 (JSON 格式):

{
  "mcpServers": {
    "gaia-vault-mcp": {
      "command": "npx",
      "args": ["-y", "gaia-vault-mcp@latest"],
      "env": {
        "AZURE_STORAGE_CONNECTION_STRING": "your-connection-string-here" // 替换为您的 Azure Storage Connection String
      }
    }
  }
}

配置说明:

'"command": "npx"': 指定启动服务器的命令为 'npx'。
'"args": ["-y", "gaia-vault-mcp@latest"]': 'npx' 的参数，'-y' 表示自动确认安装，'gaia-vault-mcp@latest' 指定要运行的 npm 包及其版本。
'"env": { "AZURE_STORAGE_CONNECTION_STRING": "your-connection-string-here" }': 设置环境变量，'AZURE_STORAGE_CONNECTION_STRING' 是 Gaia Vault MCP Server 用来连接 Azure Blob Storage 的连接字符串。

基本使用方法

成功配置并启动 Gaia Vault MCP Server 后，您可以在 MCP 客户端中使用以下工具 (Tools) 与 Azure Blob Storage 交互：

upload-blob: 上传文件到 Azure Blob Storage。
- 需要参数: 'containerName' (容器名称), 'blobName' (Blob 名称), 'filePath' (本地文件路径) 或 'textContent' (文本内容)。
download-blob: 从 Azure Blob Storage 下载文件。
- 需要参数: 'containerName' (容器名称), 'blobName' (Blob 名称), 'pathFile' (本地保存路径) 或 'asText: true' (返回文本内容)。
list-blobs: 列出 Azure Blob Storage 容器中的所有 Blob。
- 需要参数: 'containerName' (容器名称)。

使用示例 (在支持 MCP 工具调用的 LLM 客户端中):

上传文件: 'upload-blob containerName:documents blobName:report.pdf filePath:./report.pdf'
下载文件: 'download-blob containerName:documents blobName:report.pdf pathFile:./downloaded_report.pdf'
列出容器文件: 'list-blobs containerName:documents'

请根据您的 MCP 客户端的具体使用方式调用这些工具。

关键词