Masv

MASV MCP サーバー

⚠️ 実験的なサーバー：これは、関心度と統合の可能性を測るために作成された実験的な MCP サーバーです。厳格な社内検証プロセスは実施されていません。今後のサポートと更新は、可能な範囲で提供します。皆さまからのご意見をお待ちしています！ご質問や問題がある場合は、[email protected] までお問い合わせください。

LLM が MASV API とやり取りするためのツールを提供する MCP（Model Context Protocol）サーバーです。

MASV とは？

MASV は、あらゆる規模のチーム向けに設計された、使いやすく非常に信頼性の高いマネージドファイル転送サービスです。ユーザーはサイズ制限なく大容量ファイルを送受信でき、クラウド、オンプレミス、ハイブリッドのワークフローに対応する堅牢なクラウドインフラストラクチャによって、データの完全性とセキュリティが確保されます。

詳しくはこちら https://masv.io/

要件

Node.js 24 以降。 公開されているパッケージは ES2024 にコンパイルされたプレーンな JavaScript であるため、トランスパイルやポリフィルは必要ありません。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 に設定すると、LLM によるパッケージとポータルの削除ツールの使用が許可されます（デフォルト：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 フラグを指定すると、確認プロンプトなしでパッケージの実行が自動的に承認されます。

利用可能なツール

サーバーは、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 - クラウドインテグレーションと 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