consul-mcp-server

consul-mcp-server

8
cloud_platforms

Consul MCP Server is a Model Context Protocol server enabling access to Consul's features through a standardized interface. It supports functions like service management, health checks, a key-value store, sessions, events, and more, making it highly useful for managing Consul infrastructure.

Consul MCP Server 🚀

smithery badge

A Model Context Protocol (MCP) server that provides access to Consul's functionality through a standardized interface.

Consul Server MCP server

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

  1. Start the server:
node build/index.js
  1. The server will connect to Consul and make all functionality available through the MCP interface.

Development

  1. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. 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