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 
konduct tool list

3.启动上游MCP服务器

konduct start

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

常见工作流程

根据项目范围运行

konduct project create --name Dev --description "Development tools"
konduct project add-server 
 
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  --transport stdio --command  --args 
konduct server list
konduct server discover 
konduct server enable 
konduct server disable 
konduct server remove 

工具管理

konduct tool list
konduct tool enable 
konduct tool disable 

项目管理

konduct project create --name  [--description ]
konduct project list
konduct project add-server 
 
konduct project remove-server 
 

运行时和诊断

konduct start
konduct start --project 

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 
konduct tool list

项目暴露了错误的服务器

检查项目成员资格：

konduct project list
konduct server list

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

客户端无法连接

从以下内容开始：

konduct doctor

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

konduct connect