AI导哈

MCP服务器管理工具

mcp-konduct是一个本地控制平面，用于通过单一接口管理多个MCP服务器，包括服务器注册、工具发现、项目分组、活动检查等功能。

  • by dretureta
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 dretureta/mcp-konduct

使用说明

mcp产品

一个本地控制平面，用于管理一个干净接口后面的多个MCP服务器。

mcp-konduct 允许您注册下游MCP服务器，发现和控制它们的工具，按项目对它们进行分组，检查web仪表板中的活动，并通过单个上游MCP入口点公开所有内容。

为什么要用它

当您使用多个MCP服务器时，事情很快就会变得一团糟：

  • 客户端配置重复
  • 工具名称可能会冲突
  • 某些工具只应在特定上下文中可见
  • 跨项目调试请求很痛苦

mcp-konduct 给你一个地方来管理它。

它能做什么

  • 注册MCP服务器 标准, 上海证券交易所，或 可流式传输http
  • 发现工具并单独启用或禁用它们
  • 将所有配置的服务器作为单个上游MCP服务器公开
  • 按以下方式查看工具访问范围 项目
  • 使用项目/会话上下文跟踪请求日志
  • 导入和导出配置备份
  • 从a管理一切 命令行界面 或内置 网络仪表盘

[！注意] 最近的强化工作增加了更严格的验证、API响应和导出中更安全的秘密处理、事务导入行为，以及工具更强的备份身份保护。

安装

来自npm

npm install -g mcp-konduct

然后，您可以使用以下任一命令：

konduct doctor
# or
mcp-konduct doctor

来源

git clone https://github.com/dretureta/mcp-konduct.git
cd mcp-konduct
npm install
npm run build
npm link --force

快速开始

1.添加服务器

konduct server add \
  --name filesystem \
  --transport stdio \
  --command npx \
  --args -y @modelcontextprotocol/server-filesystem /tmp

2.发现它的工具

konduct server list
konduct server discover <server-id>
konduct tool list

3.启动上游MCP服务器

konduct start

您的MCP客户端现在可以连接到 konduct 而不是单独连接到每个下游服务器。

常见工作流程

根据项目范围运行

konduct project create --name Dev --description "Development tools"
konduct project add-server <project-id> <server-id>
konduct start --project Dev

只有链接到该项目的服务器才会暴露在上游。

启动仪表板

konduct start --dashboard --port 3847

然后打开：

http://localhost:3847

仪表板包括：

  • 服务器注册和编辑
  • 工具发现和切换
  • 项目管理
  • 范围化项目视图
  • 请求日志检查
  • 备份导入/导出

生成客户端配置

konduct connect opencode
konduct connect cursor --project Dev
konduct connect claude --install

按键命令

服务器管理

konduct server add --name <name> --transport stdio --command <cmd> --args <args...>
konduct server list
konduct server discover <server-id>
konduct server enable <server-id>
konduct server disable <server-id>
konduct server remove <server-id>

工具管理

konduct tool list
konduct tool enable <tool-id>
konduct tool disable <tool-id>

项目管理

konduct project create --name <name> [--description <text>]
konduct project list
konduct project add-server <project-id> <server-id>
konduct project remove-server <project-id> <server-id>

运行时和诊断

konduct start
konduct start --project <project-name>
konduct start --dashboard --port 3847
konduct status
konduct logs --last 50
konduct doctor

进出口

您可以导出当前配置，稍后再导入。

当前行为：

  • 备份有效载荷保留 工具UUID 为了更好的身份连续性
  • 默认情况下，导出对机密是安全的
  • 合并导入是事务性的

如果您针对API编写脚本，请将备份视为配置加上稳定的工具标识，而不仅仅是松散的快照。

数据库位置

mcp-konduct 将状态存储在SQLite中。

  • Linux： ~/.config/mcp-konduct/konduct.db
  • macOS： ~/Library/Application Support/mcp-konduct/konduct.db
  • 窗户： %APPDATA%/mcp-konduct/konduct.db

若要重置本地状态，请删除数据库文件并重新启动。

发展

安装

npm install

运行测试

npm test

构建

npm run build

在开发中运行命令

npm run dev -- server list
npm run dev -- start --dashboard

有用的项目文件

  • src/cli/index.ts --CLI入口点
  • src/core/registry.ts --注册表和持久性逻辑
  • src/core/settings-backup-service.ts --备份/导入逻辑
  • src/web/index.ts --网页合成根
  • src/web/servers.ts / projects.ts / tools.ts / logs.ts / stats.ts --路由模块
  • AGENTS.md --编码规范和代码仓库指南

故障排除

工具未显示

确保你发现了它们：

konduct server discover <server-id>
konduct tool list

项目暴露了错误的服务器

检查项目成员资格：

konduct project list
konduct server list

然后从该项目中重新添加或删除相关服务器。

客户端无法连接

从以下内容开始：

konduct doctor

然后使用以下命令验证生成的客户端配置：

konduct connect <client>

相关 MCP