内容
# MASV MCP 服务器
> **⚠️ 实验性服务器**: 这是一个实验性的MCP服务器，旨在衡量兴趣和集成潜力。它尚未经过我们严格的内部验证过程。我们将尽力提供进一步的支持和更新。 我们想听听您的意见！如果您有任何问题或问题，请联系我们 [support@masv.io](mailto:support@masv.io)。
一个MCP（模型上下文协议）服务器，为LLM提供与MASV API交互的工具。
## 什么是MASV？
MASV是一种易于使用且极其可靠的托管文件传输服务，适用于各种规模的团队。它允许用户发送和接收大量文件，没有大小限制，同时通过其强大的云基础设施确保数据完整性和安全性，支持云端、本地和混合工作流程。
了解更多 https://massive.io/
## 安装
服务器可以直接使用`npx`运行，无需安装，也可以通过全局安装：
```bash
# 直接使用npx（推荐）
npx @getmasv/masv-mcp-server
# 或全局安装
npm install -g @getmasv/masv-mcp-server
```
## 配置
### 必需的环境变量
服务器需要以下环境变量来与MASV API进行身份验证：
- `MASV_TEAM_ID` - 您的MASV团队标识符
- `MASV_API_KEY` - 您的MASV API身份验证密钥
### 可选的环境变量
- `MASV_ALLOW_DELETE` - 设置为`true`以允许LLM使用包和门户删除工具（默认：`false`）
### MCP客户端配置
将服务器添加到您的MCP客户端配置文件中：
```json
{
"mcpServers": {
"masv": {
"command": "npx",
"args": ["-y", "@getmasv/masv-mcp-server"],
"env": {
"MASV_TEAM_ID": "您的团队ID",
"MASV_API_KEY": "您的API密钥"
}
}
}
}
```
**注意**：`-y`标志会自动确认软件包执行而无需提示。
## 可用工具
服务器为LLM交互提供了以下工具：
### 包管理
- `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` - 浏览云集成上的文件
- `list_files_on_storage_gateway` - 浏览存储网关上的文件
- `transfer_files_from_integration` - 将文件从存储传输到MASV（适用于云和MASV存储网关）
### 团队管理
- `get_team_members` - 列出团队成员及其详情
## 许可证
MIT
## 支持
如有疑问、问题或反馈，请联系我们 [support@masv.io](mailto:support@masv.io)。
## 开发
### 安装依赖
```
npm install
```
### 构建
```
npm run build
```
### 使用MCP服务器
在LLM聊天应用程序中添加命令以启动服务器：
```
node /path/to/masv-mcp-server/build/index.js
```
运行MCP检查器以检查和执行工具
```
npm run inspector
```
