AM

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

Created 3 months ago

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

development documentation public

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

The Consul MCP Server provides access to various Consul functionalities including service management, health checks, key-value store operations, session management, event handling, prepared queries, status checks, agent information, and system health service information. It can be configured using environment variables and is designed to be easily installed and run.

Documentation

MseeP.ai Security Assessment Badge

Consul MCP Server 🚀

smithery badge

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

  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

Server Config

{
  "mcpServers": {
    "a-model-context-protocol-(mcp)-server-that-provides-access-to-consul's-functionality-through-a-standardized-interface.-server": {
      "command": "npx",
      "args": [
        "a-model-context-protocol-(mcp)-server-that-provides-access-to-consul's-functionality-through-a-standardized-interface."
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: Aug 07, 2025
Updated At: Aug 07, 2025
Author: kocierik
Category: MCP Server
License: MIT
Tags:
development documentation public