Massdriver

Massdriver MCP サーバー

Massdriver 向けの Model Context Protocol（MCP）サーバーです。AI アシスタントに、プロジェクト、環境、デプロイ、ポリシーなどのインフラストラクチャプラットフォームを管理するツールを提供します。

インストール

このサーバーは、公式 MCP レジストリに cloud.massdriver/mcp-server として公開されています。レジストリに対応した MCP クライアントでは、この名前で検索してインストールできます。

手動でインストールする場合は、お使いの環境に合った方法を選んでください。

リリースバイナリをダウンロードする — GitHub Releases からお使いのプラットフォーム（Linux、macOS、Windows、amd64、arm64）のアーカイブをダウンロードし、mcp-server を PATH に配置します。

Go install（Go 1.25 以降が必要です）：

go install github.com/massdriver-cloud/mcp-server@latest

Docker：

docker pull massdrivercloud/mcp-server

ソースからビルドする：

git clone https://github.com/massdriver-cloud/mcp-server.git
cd mcp-server
make build   # outputs ./bin/mcp-server

設定

Massdriver API キーと組織 ID が必要です。API 認証情報の作成方法については、Massdriver のドキュメントをご覧ください。

サーバーは、環境変数または ~/.config/massdriver/config.yaml 内のプロファイルから設定を読み込みます。

export MASSDRIVER_API_KEY="your-api-key"
export MASSDRIVER_ORGANIZATION_ID="your-org-id"
# Optional:
export MASSDRIVER_URL="https://api.massdriver.cloud"  # set this if you run a self-hosted Massdriver instance
export MASSDRIVER_PROFILE="default"                   # named profile in ~/.config/massdriver/config.yaml

トランスポート

デフォルトでは、このサーバーは stdio 経由で MCP を使用します（Claude Desktop などのローカルツール連携向け）。代わりに Streamable HTTP トランスポートを使用するには、-http を指定するか、MASSDRIVER_MCP_HTTP_ADDR を設定します。

./bin/mcp-server -http 127.0.0.1:8080

HTTP エンドポイントはステートレスで application/json を返すため、単一のツール呼び出しは通常の POST で実行できます（セッションハンドシェイクは不要です）。

curl -s 127.0.0.1:8080 \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_viewer","arguments":{}}}'

HTTP エンドポイントは認証されておらず、インフラストラクチャを変更するツールを公開します。 localhost にバインドするか、認証プロキシの背後に配置してください。

Docker

stdio トランスポートには対話型の stdin が必要なため、-i を指定してください。

docker run --rm -i \
  -e MASSDRIVER_API_KEY \
  -e MASSDRIVER_ORGANIZATION_ID \
  massdrivercloud/mcp-server

セルフホスト型の Massdriver インスタンスでは、-e MASSDRIVER_URL も指定してください。

プロファイルを使用していますか？ MASSDRIVER_PROFILE は、 コンテナ内には存在しない ~/.config/massdriver/config.yaml から認証情報を読み込みます。 上記のように認証情報を環境変数として渡すか、設定ディレクトリをマウントして XDG_CONFIG_HOME をその場所に指定してください。

docker run --rm -i \
  -e MASSDRIVER_PROFILE \
  -e XDG_CONFIG_HOME=/config \
  -v ~/.config/massdriver:/config/massdriver:ro \
  massdrivercloud/mcp-server

MCP クライアントの設定

Claude Code

claude mcp add massdriver \
  --env MASSDRIVER_API_KEY=your-api-key \
  --env MASSDRIVER_ORGANIZATION_ID=your-org-id \
  -- /path/to/mcp-server

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "massdriver": {
      "command": "/path/to/mcp-server",
      "env": {
        "MASSDRIVER_API_KEY": "your-api-key",
        "MASSDRIVER_ORGANIZATION_ID": "your-org-id"
      }
    }
  }
}

その他のクライアント

このサーバーは stdio トランスポートを使用し、あらゆる MCP クライアントと互換性があります。

利用可能なツール（111）

ツールごとの説明、入力規約、ページネーション、動作に関する注釈など、ツールの全リファレンスについては MCP_README.md をご覧ください。

プロジェクト（6）

list_projects get_project create_project clone_project update_project delete_project

環境（13）

list_environments get_environment create_environment update_environment delete_environment set_environment_default remove_environment_default compare_environments fork_environment deploy_environment decommission_environment list_environment_links list_environment_unfulfilled_dependencies

インスタンス（10）

list_instances get_instance update_instance set_instance_secret remove_instance_secret set_remote_reference remove_remote_reference copy_instance orphan_instance list_alarms

デプロイ（11）

list_deployments get_deployment get_deployment_logs create_deployment propose_deployment approve_deployment reject_deployment abort_deployment plan_deployment rollback_deployment compare_deployments

コンポーネント（8）

list_components get_component add_component update_component set_component_position remove_component link_components unlink_components

バンドル（1）

get_bundle

リソース（9）

list_resources get_resource create_resource update_resource delete_resource export_resource create_resource_grant delete_resource_grant list_resource_grants

リソースタイプ（2）

get_resource_type list_resource_type_dependents

組織（8）

get_organization create_custom_attribute update_custom_attribute delete_custom_attribute list_organization_members list_custom_attributes get_organization_settings update_organization_settings

ビューアー（1）

get_viewer

監査ログ（3）

get_audit_log list_audit_logs list_audit_log_event_types

グループ（14）

list_groups get_group create_group update_group delete_group add_group_user remove_group_user revoke_group_invitation add_group_service_account remove_group_service_account list_group_members list_group_service_accounts list_group_invitations list_group_policies

サービスアカウント（4）

list_service_accounts get_service_account update_service_account delete_service_account

サービスアカウントの作成は意図的に公開していません。MCP サーバーが新しい認証情報を発行することはありません。

OCI リポジトリ（8）

list_oci_repos get_oci_repo create_oci_repo update_oci_repo delete_oci_repo create_oci_repo_grant delete_oci_repo_grant list_oci_repo_grants

ポリシー（11）

get_policy create_policy update_policy delete_policy list_policy_actions list_policy_entities evaluate_policy evaluate_policies_batch explain_policy get_policy_attribute_schema list_policy_attribute_values

サーバー（1）

get_server

URL（1）

get_url

コントリビューション

開発、アーキテクチャ、リリースに関するドキュメントはCONTRIBUTING.mdにあります。

ライセンス

MIT