使用说明

项目简介

Tigris MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接大型语言模型 (LLM) 客户端与 Tigris 对象存储服务。通过 Tigris MCP Server，LLM 客户端可以安全、便捷地访问和管理存储在 Tigris 云平台上的数据资源。该服务器提供了一系列预定义的工具，允许 LLM 执行诸如列出存储桶、创建存储桶、上传/下载对象等操作，从而扩展 LLM 的数据处理和交互能力。

主要功能点

存储桶管理：支持列出、创建和删除 Tigris 存储桶。
对象管理：支持列出存储桶中的对象、上传本地文件到存储桶、从存储桶下载对象以及删除存储桶中的对象。
工具化访问：以标准化的 MCP 工具形式向 LLM 客户端暴露 Tigris 对象存储的功能，方便 LLM 进行调用和集成。
易于配置：提供简单的初始化配置步骤，支持 AWS 凭证配置或 AWS Profiles，方便用户快速部署和使用。

安装步骤

安装 Tigris MCP Server：打开终端，运行以下命令即可安装 Tigris MCP Server。
```
npx -y @tigrisdata/tigris-mcp-server init
```
按照提示完成初始化配置。

服务器配置

MCP 服务器配置用于告知 MCP 客户端（例如 Claude 或 Cursor）如何连接和启动 Tigris MCP Server。您需要将以下 JSON 配置添加到您的 MCP 客户端配置文件中。

Claude Desktop 配置: 打开 Claude Desktop 的配置文件 'claude_desktop_config.json' (通常位于 '~/Library/Application Support/Claude/')，在 'mcpServers' 字段中添加以下配置：

{
  "mcpServers": {
    "tigris-mcp-server": {
      "command": "npx",
      "args": ["-y", "@tigrisdata/tigris-mcp-server", "run"],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_AWS_ACCESS_KEY_ID",  // 您的 AWS/Tigris Access Key ID，如果您不使用 AWS Profiles
        "AWS_SECRET_ACCESS_KEY": "YOUR_AWS_SECRET_ACCESS_KEY", // 您的 AWS/Tigris Secret Access Key，如果您不使用 AWS Profiles
        "AWS_ENDPOINT_URL_S3": "https://fly.storage.tigris.dev" // Tigris S3 Endpoint URL，通常无需修改
      }
    }
  }
}

Cursor 配置: 在 Cursor 编辑器的设置中，找到 "MCP" 或 "Model Context Protocol" 相关设置，点击 "Add new global MCP server"，然后添加以下配置：

{
  "mcpServers": {
    "tigris-mcp-server": {
      "command": "npx",
      "args": ["-y", "@tigrisdata/tigris-mcp-server", "run"],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_AWS_ACCESS_KEY_ID",  // 您的 AWS/Tigris Access Key ID，如果您不使用 AWS Profiles
        "AWS_SECRET_ACCESS_KEY": "YOUR_AWS_SECRET_ACCESS_KEY", // 您的 AWS/Tigris Secret Access Key，如果您不使用 AWS Profiles
        "AWS_ENDPOINT_URL_S3": "https://fly.storage.tigris.dev" // Tigris S3 Endpoint URL，通常无需修改
      }
    }
  }
}

使用 AWS Profiles (可选): 如果您已配置 AWS CLI 并且希望使用 AWS Profiles，可以使用以下配置，将 'YOUR_AWS_PROFILE_NAME' 替换为您的 AWS Profile 名称：

{
  "mcpServers": {
    "tigris-mcp-server": {
      "command": "npx",
      "args": ["-y", "@tigrisdata/tigris-mcp-server", "run"],
      "env": {
        "USER_AWS_PROFILES": "true",
        "AWS_PROFILE": "YOUR_AWS_PROFILE_NAME", // 您的 AWS Profile 名称，例如 "default"
        "AWS_ENDPOINT_URL_S3": "https://fly.storage.tigris.dev" // Tigris S3 Endpoint URL，通常无需修改
      }
    }
  }
}

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您应该能够看到名为 "Tigris MCP Server" 的服务器。LLM 可以通过调用该服务器提供的工具来操作 Tigris 对象存储。

例如，您可以指示 LLM 执行以下操作：

"列出我所有的 Tigris 存储桶" (对应 'tigris_list_buckets' 工具)
"创建一个名为 'my-new-bucket' 的 Tigris 存储桶" (对应 'tigris_create_bucket' 工具)
"列出存储桶 'my-bucket' 中的所有对象" (对应 'tigris_list_objects' 工具)
"从我的本地文件 '/path/to/my/file.txt' 上传到存储桶 'my-bucket'，对象键为 'my-object.txt'" (对应 'tigris_put_object_from_path' 工具)

请参考工具名称和描述，结合您的 LLM 客户端的具体使用方式，来调用 Tigris MCP Server 提供的功能。

关键词