Consul MCP Server

by kocierik
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides access to Consul functionality including service management, health checks, key-value store operations, session management, event handling, prepared queries, status information, agent operations, and system health monitoring.

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

  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" ] } } }

License

MIT

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Provides access to Consul functionality (services, health checks, KV store, sessions, events, queries, etc.) through a standardized Model Context Protocol interface.

  1. Features
    1. Service Management
    2. Health Checks
    3. Key-Value Store
    4. Sessions
    5. Events
    6. Prepared Queries
    7. Status
    8. Agent
    9. System
  2. Configuration
    1. Usage
      1. Development
        1. Claude config
          1. License
            ID: fy1voql75b