Masv

MASV MCP 服务

⚠️ 实验性服务：这是一个实验性 MCP 服务，旨在了解大家的兴趣和集成潜力。它尚未经过我们严格的内部验证流程。我们将尽力提供后续支持和更新。欢迎向我们反馈！如有任何问题，请通过 [email protected] 联系我们。

一个 MCP（Model Context Protocol）服务，为大模型提供与 MASV API 交互的工具。

什么是 MASV？

MASV 是一项易于使用且超可靠的托管文件传输服务，适用于各种规模的团队。用户可以在不受文件大小限制的情况下发送和接收超大文件，同时依托其强大的云基础架构确保数据完整性和安全性，并支持云端、本地部署和混合工作流。

了解更多 https://masv.io/

要求

Node.js 24 或更高版本。 发布的包是编译为 ES2024 的纯 JavaScript，因此无需转译或 polyfill。项目基于 Node 24 构建和测试，测试套件也要求使用该版本——它通过 Node 内置的类型剥离功能直接导入 TypeScript 源码。

安装

该服务可以通过 npx 直接运行，无需安装；也可以根据需要全局安装：

# Run directly with npx (recommended)
npx @getmasv/masv-mcp-server

# Or install globally
npm install -g @getmasv/masv-mcp-server

配置

必需的环境变量

该服务需要以下环境变量来通过 MASV API 进行身份验证：

• MASV_TEAM_ID - MASV 团队标识符
• MASV_API_KEY - MASV API 身份验证密钥

可选的环境变量

• MASV_ALLOW_DELETE - 设置为 true 以允许大模型使用包和门户删除工具（默认值：false）

MCP 客户端配置

将该服务添加到 MCP 客户端配置文件中：

{
  "mcpServers": {
    "masv": {
      "command": "npx",
      "args": ["-y", "@getmasv/masv-mcp-server"],
      "env": {
        "MASV_TEAM_ID": "your-team-id",
        "MASV_API_KEY": "your-api-key"
      }
    }
  }
}

注意：-y 标志会自动确认执行软件包，无需提示。

可用工具

该服务提供以下工具，供大模型交互使用：

包管理

• get_packages - 列出团队包
• get_package - 按 ID 获取包详情
• get_portal_packages - 列出上传到门户的包
• get_package_files - 列出包中的文件
• get_package_transfers - 获取包传输历史记录
• update_package_expiration_date_and_time - 修改包的过期时间
• delete_package - 删除包（需要 MASV_ALLOW_DELETE=true）

门户管理

• get_portals - 列出所有门户
• get_portal - 按 ID 获取门户详情
• create_portal - 创建新门户
• update_portal - 更新门户配置
• delete_portal - 删除门户（需要 MASV_ALLOW_DELETE=true）

活动跟踪

• get_activities - 列出活动和事件
• get_activity_events - 获取某项活动的事件历史记录
• get_activities_information - 获取活动状态的详细说明

集成管理

• get_integrations - 列出已连接的存储集成
• send_package_to_integration - 将包传输到已连接的存储
• list_files_on_integration - 浏览云集成和 MASV Storage Gateway 上的文件
• transfer_files_from_integration - 将文件从存储传输到 MASV（适用于云存储和 MASV Storage Gateway）

团队管理

• get_team_members - 列出团队成员及其详情

许可证

MIT

支持

如有问题、故障或反馈，请通过 [email protected] 联系我们。

开发

安装依赖项

npm install

构建

npm run build

格式化

npm run format

使用 Prettier，列宽为 100。CI 会运行 npm run format:check，并在文件格式不符合要求时失败。

测试

npm test
npm run test:coverage

使用 Node 内置的测试运行器运行离线测试套件。它无需 MASV 凭据，也不会发起网络请求，因此每个拉取请求都会运行此测试；由于 Node 可直接运行 TypeScript 源文件，因此无需构建步骤。

src/ 中的相对导入使用 .ts 扩展名，以便 Node 直接运行源文件；tsc 会在输出时将其重写为 .js。新增导入时请保持这种形式，并注意，Node 的类型剥离不支持 TypeScript 的 enum、namespace 和构造函数参数属性。

使用 MCP 服务

在 LLM 聊天应用中添加启动服务的命令：

node /path/to/masv-mcp-server/build/index.js

运行 MCP inspector 以检查和执行工具：

npm run inspector