MCP server that provides BOSH Director operations to AI assistants like Claude
{
"mcpServers": {
"bosh-mcp-server": {
"command": "<see-readme>",
"args": []
}
}
}No install config available. Check the server's README for setup instructions.
Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
MCP server that provides BOSH Director operations to AI assistants like Claude
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
MIT. View license →
Is it maintained?
Last commit 133 days ago.
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
No automated test available for this server. Check the GitHub README for setup instructions.
No known vulnerabilities.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationHave you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Dynamic problem-solving through sequential thought chains
A Model Context Protocol server for searching and analyzing arXiv papers
An open-source AI agent that brings the power of Gemini directly into your terminal.
The official Python SDK for Model Context Protocol servers and clients
MCP Security Weekly
Get CVE alerts and security updates for Bosh Mcp Server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
An MCP (Model Context Protocol) server that provides BOSH Director operations to AI assistants like Claude.
git clone https://github.com/malston/bosh-mcp-server.git
cd bosh-mcp-server
go build -o bosh-mcp-server ./cmd/bosh-mcp-server
Download the latest release from the releases page.
The server resolves BOSH credentials in order of precedence:
Environment variables (highest priority)
export BOSH_ENVIRONMENT=https://10.0.0.5:25555
export BOSH_CLIENT=admin
export BOSH_CLIENT_SECRET=secret
export BOSH_CA_CERT=/path/to/ca.crt
BOSH config file (~/.bosh/config)
Ops Manager (fallback)
export OM_TARGET=https://opsman.example.com
export OM_USERNAME=admin
export OM_PASSWORD=secret
The server calls om bosh-env and caches credentials for 5 minutes.
Optional configuration via ~/.bosh-mcp/config.yaml:
# Token TTL for confirmation tokens (seconds)
token_ttl: 300
# Operations requiring confirmation tokens
confirm_operations:
- delete_deployment
- recreate
- stop
- cck
# Operations blocked entirely
blocked_operations: []
Set BOSH_MCP_CONFIG to use a custom config path.
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"bosh": {
"command": "/path/to/bosh-mcp-server",
"env": {
"BOSH_ENVIRONMENT": "https://10.0.0.5:25555",
"BOSH_CLIENT": "admin",
"BOSH_CLIENT_SECRET": "your-secret",
"BOSH_CA_CERT": "/path/to/ca.crt"
}
}
}
}
| Tool | Description |
|------|-------------|
| bosh_vms | List VMs for a deployment |
| bosh_instances | List instances with process details |
| bosh_tasks | List recent BOSH tasks |
| bosh_task | Get details of a specific task |
| bosh_task_wait | Wait for a task to complete |
| Tool | Description |
|------|-------------|
| bosh_stemcells | List uploaded stemcells |
| bosh_releases | List uploaded releases |
| bosh_deployments | List all deployments |
| bosh_cloud_config | Get current cloud config |
| bosh_runtime_config | Get runtime configs |
| bosh_cpi_config | Get CPI config |
| bosh_variables | List variables for a deployment |
| bosh_locks | Show current deployment locks |
| Tool | Description | Confirmation Required |
|------|-------------|----------------------|
| bosh_delete_deployment | Delete a deployment | Yes |
| bosh_recreate | Recreate VMs | Yes |
| bosh_stop | Stop jobs | Yes |
| bosh_start | Start jobs | No |
| bosh_restart | Restart jobs | No |
All deployment tools wait for task completion by default (configurable timeout).
Destructive operations require a two-step confirmation:
Request operation (without confirm parameter):
bosh_delete_deployment(deployment: "my-app")
→ {"requires_confirmation": true, "confirmation_token": "tok_abc123", ...}
Confirm operation (with token):
bosh_delete_deployment(deployment: "my-app", confirm: "tok_abc123")
→ {"task_id": 456, "state": "done", ...}
Tokens expire after 5 minutes (configurable) and are single-use.