基本能力
产品定位
Heimdall 是一个轻量级的服务，用于管理本地的 MCP 服务器。它可以通过简单的 npx 命令安装，并允许为 MCP 客户端授权特定的 MCP 服务器工具。所有 MCP 客户端都可以访问相同的配置。
核心功能
- 管理本地 MCP 服务器
- 授权特定的 MCP 服务器工具
- 提供统一的配置访问
适用场景
- 需要管理多个 MCP 服务器的开发环境
- 需要为不同 MCP 客户端授权特定工具的场景
工具列表
setup: 设置脚本，用于初始化配置controls.json: 用于管理授权的工具config.json: 用于管理服务器列表
常见问题解答
- 可用工具限制: 某些 MCP 客户端对可用工具数量有限制，例如 Cursor 最多支持 40 个工具。
- 日志: 运行实例的日志存储在
~/.heimdall/logs目录中。 - 孤儿进程: 如果 MCP 客户端意外关闭，可能会有孤儿进程需要手动清理。
使用教程
使用依赖
- Node.js
- npm 或 pnpm
安装教程
通过 NPX（推荐）
- 运行设置脚本（如果没有提供路径，会生成一个空配置）:
npx @shinzolabs/heimdall setup <optional: path/to/current/config.json>
通过本地实例
-
下载包:
bash
git clone https://github.com/shinzo-labs/heimdall.git -
安装并构建依赖:
bash
cd heimdall && pnpm i && pnpm build -
运行设置脚本（如果没有提供路径，会生成一个空配置）:
pnpm run setup <optional: path/to/current/config.json> <optional: path to `index.js` file in local Heimdall instance, ex. `/path/to/local/heimdall/dist/index.js`>
调试方式
- 检查日志文件:
~/.heimdall/logs - 清理孤儿进程:
bash
pkill -aif node
