Consul MCP Server 🚀
About
An MCP server providing access to Consul's service discovery and configuration features.
Explore
- List, register, and deregister services
- Manage health checks for services
- Get, put, list, and delete KV store keys
- Create and destroy sessions
- Fire and list events
- Create and execute prepared queries
- Get current leader and peers
- Retrieve agent members and self information
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Consul MCP Server 🚀Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The server can be configured using environment variables:
- CONSUL_HOST: Consul server host (default: localhost)
- CONSUL_PORT: Consul server port (default: 8500)
{
"mcpServers": {
"consul-mcp": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/consul-mcp-server/build/index.js"
]
}
}
}
To install Consul Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @kocierik/consul-mcp-server --client claude
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"consul mcp server \ud83d\ude80": {
"consul-mcp-server": {
"command": "node",
"args": [
"build/index.js"
]
}
}
}
}McpServers
{
"consul-mcp-server": {
"command": "node",
"args": [
"build/index.js"
]
}
}A Model Context Protocol (MCP) server that provides access to Consul's functionality through a standardized interface.
<p align="center">
<a href="https://glama.ai/mcp/servers/@kocierik/consul-mcp-server">
</a>
<center>
<video src="https://github.com/user-attachments/assets/81bf7d70-e837-4c99-8312-2c85ccace1f4"></video>
</center>
</p>
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 informationHealth Checks
- Register health checks - Deregister health checks - Get health checks for servicesKey-Value Store
- Get values from KV store - List keys in KV store - Put values in KV store - Delete keys from KV storeSessions
- List sessions - Destroy sessionsEvents
- Fire events - List eventsPrepared Queries
- Create prepared queries - Execute prepared queriesStatus
- Get current leader - Get current peersAgent
- Get agent members - Get agent self informationSystem
- Get system health service informationConfiguration
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
2. The server will connect to Consul and make all functionality available through the MCP interface.
Development
1. Install dependencies:
npm install
2. Build the project:
npm run build
3. 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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
