mcp产品
 ](https://www.npmjs.com/package/mcp-konduct) ](https://nodejs.org) 
一个本地控制平面,用于管理一个干净接口后面的多个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 /tmp2.发现它的工具
konduct server list
konduct server discover
konduct tool list3.启动上游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 