About Consul MCP Server 🚀
Consul MCP Server exposes Consul functionality through a standardized interface for MCP clients, for workflows that manage service discovery and cluster status through an agent. It covers services, health checks, key-value storage, sessions, events and prepared queries.
Key features
- 01Register and manage services
- 02Manage service health checks
- 03Read and write key-value data
- 04List and destroy sessions
- 05Fire and list events
- 06Manage prepared queries and cluster status
Use cases
- 01Inspect the service catalog and service details
- 02Register services and maintain health checks
- 03Read or update Consul key-value data
- 04Check the cluster leader and members
MCP support
As an MCP server, it gives MCP clients access to Consul service management, health checks, key-value storage, sessions, events, prepared queries, status and agent information.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project README
Consul MCP Server 🚀
A Model Context Protocol (MCP) server that provides access to Consul's functionality through a standardized interface.
Features
The server provides access to the following Consul functionality:
Service Management
- List running services
- Register and deregister services
- Get service information
- List catalog services
- Get catalog service information
Health Checks
- Register health checks
- Deregister health checks
- Get health checks for services
Key-Value Store
- Get values from KV store
- List keys in KV store
- Put values in KV store
- Delete keys from KV store
Sessions
- List sessions
- Destroy sessions
Events
- Fire events
- List events
Prepared Queries
- Create prepared queries
- Execute prepared queries
Status
- Get current leader
- Get current peers
Agent
- Get agent members
- Get agent self information
System
- Get system health service information
Configuration
The server can be configured using environment variables:
CONSUL_HOST: Consul server host (default: localhost)CONSUL_PORT: Consul server port (default: 8500)
Usage
- Start the server:
node build/index.js
- The server will connect to Consul and make all functionality available through the MCP interface.
Development
- Install dependencies:
npm install
- Build the project:
npm run build
- Run inspector:
npm run build && npx @modelcontextprotocol/inspector node build/index.js
Claude config
{
"mcpServers": {
"consul-mcp": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/consul-mcp-server/build/index.js"
]
}
}
}
Installing via Smithery
To install Consul Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @kocierik/consul-mcp-server --client claude
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.