The Consul MCP Server provides a standardized interface to manage and interact with Consul's functionality through a Model Context Protocol (MCP) interface:

Service Management: List, register, deregister, and get information about services in the catalog
Health Checks: Register, deregister, and retrieve health checks for services
Key-Value Store: Get, list, put, and delete values in the KV store
Sessions: List and destroy sessions
Events: Fire and list events
Prepared Queries: Create and execute prepared queries
Status: Get the current Consul leader and peers
Agent: Retrieve agent members and self-information, and reload agent configuration
System Health: Get system health service information

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

Related MCP server: ConnectWise Manage MCP Server

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

Consul MCP Server