Consul MCP Server

What is Consul MCP Server?

A Model Control Protocol (MCP) server for interacting with HashiCorp Consul service discovery and service mesh. It follows Anthropic's MCP specification, enabling Claude to analyze microservices architecture, create diagrams, identify issues, and provide recommendations via natural language.

How to use Consul MCP Server?

Install with npm install and build. Configure a .env file with CONSUL_HTTP_ADDR, CONSUL_HTTP_TOKEN, PORT, and USE_HTTP. Launch using npx -y consul-mcp-server (or npm start). For Cursor or Claude Desktop, add as an MCP server with the npx command and optional environment variables.

Key features of Consul MCP Server

• List and analyze all services in Consul
• Identify and diagnose failing health checks
• Generate Mermaid diagrams of service mesh
• Detect service connection issues and recommend fixes
• Get AI insights on load balancing and resource use
• Retrieve detailed metrics for individual services

Use cases of Consul MCP Server

• Analyze overall health of microservices architecture
• Create visual diagrams of service relationships
• Identify and troubleshoot failing health checks
• Get recommendations for improving service mesh setup
• Check connectivity and error rates between services

FAQ from Consul MCP Server

What is Model Control Protocol (MCP)?

MCP is an Anthropic specification that enables AI models like Claude to interact with external tools and APIs. This server connects AI agents to your Consul infrastructure.

What are the system requirements?

Node.js 18+, npm or yarn, a running Consul instance (local or remote), and Claude Desktop or Cursor IDE with Claude integration.

How do I configure the server for a remote Consul instance with ACL?

Set the CONSUL_HTTP_ADDR and CONSUL_HTTP_TOKEN environment variables in your configuration, either in a .env file or in the MCP server environment settings.

Can I run a demo environment for testing?

Yes, use the provided ./demo/setup-demo.sh script (requires Docker and Compose) to start a Consul server with demo microservices.

Does the server support stdio and HTTP modes?

Yes. Set USE_HTTP=true in the .env file for HTTP mode; omit it (or set to false) for stdio mode.