하임달

Heimdall은 로컬 MCP 서버를 관리하는 경량 서비스로, npx 명령 하나로 설치할 수 있습니다. 특정 MCP 서버 도구를 MCP 클라이언트에 권한을 부여할 수 있으며, 기기의 모든 MCP 클라이언트에서 동일한 구성에 액세스할 수 있습니다.

설치

⚠️ 참고: 자격 증명의 예상치 못한 손실을 방지하기 위해 설치 전에 MCP 서버 구성을 백업하는 것을 강력히 권장합니다.

설치 스크립트는 몇 가지 주요 작업을 수행합니다.

지정한 경로에서 mcpServers 구성 JSON을 ~/.heimdall/config.json 으로 이동합니다.
이전 mcpServers 구성 경로 대신 heimdall 에 대한 단일 구성을 삽입합니다.
현재 모든 서버에서 모든 메서드를 승인하기 위해 ~/.heimdall/controls.json 의 컨트롤을 초기화합니다.

~/.heimdall/controls.json 수정하여 지정된 서버에 대해 승인된 도구를 제한하고 ~/.heimdall/config.json 에 새 서버를 추가하는 단계는 구성을 참조하세요.

NPX를 통해 (권장)

설치 스크립트 실행(경로가 지정되지 않으면 빈 구성이 생성됨):

지엑스피1

로컬 인스턴스를 통해

패키지를 다운로드하세요:

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

종속성을 설치하고 빌드합니다.

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/config.json 의 구성을 일반 mcpServers 구성 JSON으로 업데이트하기만 하면 됩니다. ~/.heimdall/controls.json 파일에 서버와 권한이 부여된 도구를 추가하지 않으면 Heimdall에서 새 서버용 도구를 볼 수 없습니다.

승인된 도구 편집

새 서버나 기존 서버에 권한이 부여된 도구를 추가하려면 필요에 따라 ~/.heimdall/controls.json 파일에 추가하세요. 그러면 Heimdall이 몇 초 후에 내부 구성을 업데이트합니다. MCP 클라이언트가 동적 도구 목록 캐싱을 지원하는 경우, 권한이 부여된 도구가 자동으로 업데이트되는 것을 확인할 수 있습니다. 다른 클라이언트(예: Claude Desktop)의 경우 새 도구를 보려면 재시작해야 할 수 있습니다.

~/.heimdall/controls.json 의 스키마는 다음과 같습니다.

{
  "authorizedMcpServers": {
    "server1": {
      "authorizedTools": [
        "tool1",
        "tool2",
        ...
      ]
    },
    "server2": {
      "authorizedTools": [
        "tool1",
        "tool2",
        ...
      ]
    }

여러 MCP 클라이언트

기기에서 여러 MCP 클라이언트를 실행하는 경우, 각 새 클라이언트에 대해 다음 config.json 설정하여 모든 클라이언트에서 동일한 권한이 부여된 도구를 활성화할 수 있습니다(기기에 Heimdall이 이미 설정되어 있다고 가정).

{
  "mcpServers": {
    "heimdall": {
      "command": "npx",
      "args": [
        "@shinzolabs/heimdall"
      ]
    }
  }
}

문제 해결

사용 가능한 도구

일부 MCP 클라이언트는 에이전트가 동시에 사용할 수 있는 도구 수에 제한이 있습니다. 예를 들어, Cursor는 모든 서버에서 최대 40개의 도구만 지원하므로 controls.json 의 authorizedTools 합계는 이 수를 초과할 수 없습니다.

벌채 반출

실행 중인 인스턴스의 로그는 ~/.heimdall/logs 에서 확인할 수 있습니다. 각 MCP 클라이언트의 Heimdall 인스턴스와 하위 서버에 대한 로그는 무작위 UUID로 식별되는 별도의 디렉터리에 저장됩니다.

고아 자식 프로세스

MCP 클라이언트가 예기치 않게 종료되거나 종료 전에 Heimdall에 올바른 SIGTERM 신호를 전송하지 못하는 경우, 종료 후에도 기기에서 고아 node (및 npm ) 프로세스가 계속 실행 중일 수 있습니다. 당분간 이러한 프로세스는 수동으로 강제 종료해야 합니다. 기기에서 실행 중인 다른 중요한 node 프로세스가 없는 경우, 다음 명령을 사후 정리 명령으로 사용할 수 있습니다.

pkill -aif node

기여하다

여러분의 참여를 환영하며 적극 권장합니다. 질문, 의견 또는 우려 사항이 있으시면 austin@shinzolabs.com 으로 연락해 주세요.

Integrations

하임달

설치