返回 MCP 目录
public公开dns本地运行

Consul

一个提供标准化接口访问Consul功能的MCP服务器,包含服务管理、健康检查、KV存储等核心功能

article

README

🚀 Consul MCP 服务器

Consul MCP 服务器是一个借助标准化接口,为用户提供对 Consul 功能访问的 Model Context Protocol (MCP) 服务器,让用户能更便捷地操作 Consul 相关功能。

✨ 主要特性

该服务器提供对以下 Consul 功能的访问:

服务管理

  • 列出运行中的服务
  • 注册和取消注册服务
  • 获取服务信息
  • 列出目录中的服务
  • 获取目录中服务的信息

健康检查

  • 注册健康检查
  • 取消注册健康检查
  • 获取服务的健康检查状态

Key-Value 存储

  • 从 KV 存储获取值
  • 列出 KV 存储中的键
  • 向 KV 存储写入值
  • 从 KV 存储删除键

会话管理

  • 列出会话
  • 销毁会话

事件

  • 发布事件
  • 列出事件

预处理查询

  • 创建预处理查询
  • 执行预处理查询

状态信息

  • 获取当前领导者
  • 获取当前对等节点

代理信息

  • 获取代理成员
  • 获取代理自身信息

系统信息

  • 获取系统健康服务信息

📦 安装指南

服务器可以通过环境变量进行配置:

  • CONSUL_HOST:Consul 服务器主机地址(默认:localhost)
  • CONSUL_PORT:Consul 服务器端口(默认:8500)

💻 使用示例

基础用法

  1. 启动服务器:
node build/index.js
  1. 服务器将连接到 Consul 并通过 MCP 接口提供所有功能。

开发步骤

  1. 安装依赖项:
npm install
  1. 构建项目:
npm run build
  1. 运行检查工具:
 npm run build && npx @modelcontextprotocol/inspector node build/index.js

Claude 配置

{
    "mcpServers": {
        "consul-mcp": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/consul-mcp-server/build/index.js"
            ]
        }
    }
}

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端