Swarmpit
Lightweight AI-friendly Docker Swarm management
What is Swarmpit?
Swarmpit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to lightweight ai-friendly docker swarm management
Lightweight AI-friendly Docker Swarm management
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Lightweight AI-friendly Docker Swarm management
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx swarmpitConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Swarmpit
Swarmpit is a lightweight, self-hosted Docker Swarm management platform with a full REST API and built-in MCP server support, enabling AI agents to manage Docker Swarm clusters conversationally. The MCP integration exposes the Swarmpit API to AI clients like Claude Code, allowing you to deploy stacks, manage services, inspect secrets, and monitor cluster health through natural language. DevOps teams use it as the AI-friendly control plane for their on-premises Docker Swarm infrastructure without exposing raw Docker API tokens to LLM contexts.
Prerequisites
- A running Docker Swarm cluster (Docker 1.13 or newer)
- Swarmpit deployed on your cluster (via the installer or Docker Compose)
- A Swarmpit API token (generated in Swarmpit UI under Profile > API Access)
- Node.js and npx installed for running the MCP server package
- An MCP client such as Claude Code or Claude Desktop
Deploy Swarmpit on your Docker Swarm cluster
Run the Swarmpit installer container on your Swarm manager node. The installer will deploy the full Swarmpit stack including the app, agent, CouchDB, and InfluxDB.
docker run -it --rm \
--name swarmpit-installer \
--volume /var/run/docker.sock:/var/run/docker.sock \
swarmpit/install:1.9Access the Swarmpit UI and create an API token
Open Swarmpit in your browser (default port 888). Log in, then navigate to your user Profile > API Access and generate a new API token. Copy the token — you will need it for the MCP server configuration.
Configure the Swarmpit MCP server in your client
Add the Swarmpit MCP server to your MCP client configuration. Set SWARMPIT_URL to your Swarmpit instance URL and SWARMPIT_TOKEN to the API token you generated.
{
"mcpServers": {
"swarmpit": {
"command": "npx",
"args": ["github:swarmpit/mcp"],
"env": {
"SWARMPIT_URL": "https://swarmpit.example.com",
"SWARMPIT_TOKEN": "your-api-token-here"
}
}
}
}Restart your MCP client
Restart Claude Desktop or your MCP client to load the new Swarmpit server configuration. The Swarmpit tools will appear in the available tool list.
Verify connectivity by listing services
Ask your AI client to list the current services running in your Docker Swarm to verify the MCP server is connected and authenticated correctly.
Swarmpit Examples
Client configuration
MCP client configuration for the Swarmpit MCP server with URL and API token.
{
"mcpServers": {
"swarmpit": {
"command": "npx",
"args": ["github:swarmpit/mcp"],
"env": {
"SWARMPIT_URL": "https://swarmpit.example.com",
"SWARMPIT_TOKEN": "your-api-token-here"
}
}
}
}Prompts to try
Example prompts for managing Docker Swarm through the Swarmpit MCP server.
- "List all services running in the Docker Swarm cluster and their replica counts"
- "Scale the web-frontend service to 5 replicas"
- "Show me the logs for the payment-api service from the last 30 minutes"
- "Deploy the stack defined in docker-compose.prod.yml to the cluster"
- "List all secrets and volumes in the cluster — which services are using the db-password secret?"
- "What nodes are in the Swarm and which ones are running the nginx service?"Troubleshooting Swarmpit
MCP server fails to connect with authentication error
Verify SWARMPIT_TOKEN is set to a valid, active API token. Tokens are generated in the Swarmpit UI under Profile > API Access. If the token was regenerated or the user account was changed, update the config with the new token.
SWARMPIT_URL connection refused or timeout
Ensure Swarmpit is running and accessible at the URL you configured. If using HTTPS with a self-signed certificate, you may need to configure certificate trust or temporarily use HTTP for testing. Verify port 888 (or your custom port) is open in your firewall.
npx github:swarmpit/mcp fails to resolve the package
Ensure Node.js and npx are up to date (Node.js 16+ recommended). If the GitHub package reference fails, check https://github.com/swarmpit/mcp for the correct package name or alternative installation method such as a published npm package.
Frequently Asked Questions about Swarmpit
What is Swarmpit?
Swarmpit is a Model Context Protocol (MCP) server that lightweight ai-friendly docker swarm management It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Swarmpit?
Follow the installation instructions on the Swarmpit GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Swarmpit?
Swarmpit works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Swarmpit free to use?
Yes, Swarmpit is open source and available under the EPL-1.0 license. You can use it freely in both personal and commercial projects.
Swarmpit Alternatives — Similar Developer Tools Servers
Looking for alternatives to Swarmpit? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Swarmpit in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Swarmpit?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.