Heimdall

基本能力

产品定位

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（推荐）

1. 运行设置脚本（如果没有提供路径，会生成一个空配置）:

npx @shinzolabs/heimdall setup <optional: path/to/current/config.json>

通过本地实例

1. 下载包:

git clone https://github.com/shinzo-labs/heimdall.git

1. 安装并构建依赖:

cd heimdall && pnpm i && pnpm build

1. 运行设置脚本（如果没有提供路径，会生成一个空配置）:

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
• 清理孤儿进程:

pkill -aif node

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。