Massdriver

Massdriver MCP 服务

一个用于 Massdriver 的 Model Context Protocol（MCP）服务，为 AI 助手提供管理基础设施平台的工具，包括项目、环境、部署、策略等。

安装

此服务已发布到 官方 MCP Registry，名称为 cloud.massdriver/mcp-server——支持注册表的 MCP 客户端可以按此名称发现并安装它。

若要手动安装，请选择适合你设置的方式：

下载发布版二进制文件——从 GitHub Releases 下载适用于你平台（Linux、macOS 或 Windows；amd64 和 arm64）的压缩包，并将 mcp-server 放入 PATH。

Go 安装（需要 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

Bundle（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