tos-mcp

@jneless/tos-mcp

0 Stars 7 次浏览 jneless 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "tos-mcp-server": {
      "args": [
        "--from",
        "git+https://github.com/jneless/tos-mcp.git",
        "tos-mcp-server"
      ],
      "command": "uvx",
      "env": {
        "TOS_ACCESS_KEY": "your-access-key",
        "TOS_ENDPOINT": "https://tos-cn-beijing.volces.com",
        "TOS_REGION": "cn-beijing",
        "TOS_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

服务介绍

火山引擎对象存储 TOS 非官方 MCP工具

TOS 非官方 MCP 工具

快速开始

macOS 从零开始配置

1. 安装必要依赖

# 安装 Homebrew如果还没有
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Python 3如果还没有
brew install python@3.12

# 安装 uvPython 包管理器
curl -LsSf https://astral.sh/uv/install.sh | sh

# 重新加载 shell 配置
source ~/.zshrc  # 如果使用 zsh
# 或
source ~/.bash_profile  # 如果使用 bash

2. 方式一直接从 GitHub 使用推荐无需克隆

使用 uvx 可以直接从 GitHub 运行无需克隆仓库

# 直接运行会自动从 GitHub 下载和安装
uvx --from git+https://github.com/jneless/tos-mcp.git tos-mcp-server

3. 方式二克隆到本地使用

如果需要修改代码或本地开发

# 克隆项目
git clone https://github.com/jneless/tos-mcp.git
cd tos-mcp

# 自动安装依赖
uv sync

# 运行服务器
uv run tos-mcp-server

环境变量配置

复制环境变量模板

cp .env.example .env

编辑 .env 文件并填入配置或者设置环境变量

export TOS_ACCESS_KEY="your_access_key"
export TOS_SECRET_KEY="your_secret_key"
export TOS_REGION="cn-beijing"
export TOS_ENDPOINT="https://tos-cn-beijing.volces.com"

MCP 配置

方式一直接从 GitHub 安装推荐无需克隆仓库

Cline 或其他 MCP 客户端的配置文件中添加

{
  "mcpServers": {
    "tos-mcp-server": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/jneless/tos-mcp.git", "tos-mcp-server"],
      "env": {
        "TOS_ACCESS_KEY": "your-access-key",
        "TOS_SECRET_KEY": "your-secret-key",
        "TOS_REGION": "cn-beijing",
        "TOS_ENDPOINT": "https://tos-cn-beijing.volces.com"
      }
    }
  }
}

环境变量配置说明

TOS_ACCESS_KEY: 火山引擎访问密钥 ID
TOS_SECRET_KEY: 火山引擎访问密钥 Secret
TOS_REGION: TOS 服务区域如 cn-beijing
TOS_ENDPOINT: TOS 服务端点可选如果不设置会根据 region 自动生成

API 测试状态

API 名称	功能描述	分类	测试状态	测试环境	备注
`tos_create_bucket`	创建存储桶	桶管理	已测试	Cline	-
`tos_list_buckets`	列举存储桶	桶管理	已测试	Cline	-
`tos_get_bucket_meta`	获取存储桶元数据	桶管理	已测试	Cline	-
`tos_delete_bucket`	删除存储桶	桶管理	已测试	Cline	-
`tos_put_object`	上传对象	对象管理	已测试	Cline	-
`tos_get_object`	下载对象	对象管理	已测试	Cline	-
`tos_list_objects`	列举对象	对象管理	已测试	Cline	-
`tos_delete_object`	删除对象	对象管理	已测试	Cline	-
`tos_presigned_url`	生成预签名URL	预签名	已测试	Cline	-
`tos_image_process`	基础图片处理	图片处理	已测试	Cline	回写并提供 URL 下载
`tos_image_info`	获取图片信息	图片处理	已测试	Cline	-
`tos_video_snapshot`	视频截帧	视频处理	已测试	Cline	-
`tos_video_info`	获取视频信息	视频处理	已测试	Cline	回写并提供 URL 下载