Skip to main content
Glama
Sign In
ABLESTACK MOLD MCP Server

ABLESTACK MOLD MCP Server

by ycyun
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

ablestack-mcp-server

mold

ABLESTACK MOLD API를 MCP(Model Context Protocol)로 노출하는 서버입니다.
mold_* 네임스페이스의 MCP 툴을 통해 MOLD API를 직접 호출·탐색·디버그할 수 있습니다.

특징

  • 연결정보 툴: mold_getConfig, mold_setConfig (endpoint/apiKey/secret/algo 저장·조회)

  • 범용 호출: mold_call → 임의의 API 호출

  • 서명 디버그: mold_signDebug → 정규화 문자열/서명/최종 URL 확인

  • 자동 등록: mold_autoRegisterApis, mold_listApisMeta
    listApis 메타를 읽어 모든 API를 mold_<API명> 툴로 동적 등록

  • 비동기 폴링: isAsync API에 _wait, _timeoutMs, _intervalMs 옵션 지원

  • 브래킷 표기 변환: 중첩 params(JSON) → details[0].cpuNumber=8 등으로 자동 전개

  • 서명 알고리즘 토글: HMAC-SHA1/SHA256 (서버/클라 동일해야 함)

Related MCP server: Modal MCP Server

요구 사항

  • Node.js v18+

  • 네트워크에서 MOLD API endpoint에 접근 가능

설치 & 실행

# 의존성 설치
npm i

# 실행 (stdio)
node server.js

Claude Desktop(또는 MCP 클라이언트) 연동 예시

config.json (클라이언트 설정) 예시:

{
  "mcpServers": {
    "mcp-mold-server": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "MOLD_ENDPOINT": "http://10.10.32.10:8080/client/api",
        "MOLD_API_KEY": "<YOUR_API_KEY>",
        "MOLD_SECRET_KEY": "<YOUR_SECRET_KEY>",
        "MOLD_SIG_ALGO": "sha256",   // 또는 "sha1"
        "MOLD_AUTOREGISTER": "all"   // (선택) 시작 시 전체 API 자동 등록
      }
    }
  }
}

실행 후 MCP Inspector/Claude 등에서 툴이 표시됩니다.

툴 목록(핵심)

툴 이름

설명

입력 예시

mold_getConfig

현재 endpoint/apiKey(마스킹)/algo/구성파일 경로 조회

{}

mold_setConfig

연결정보 설정 및 저장(persist=true면 디스크 저장)

{"endpoint":"http://HOST:8080/client/api","apiKey":"...","secret":"...","algo":"sha256","persist":true}

mold_signDebug

서명 디버그(정규화 문자열·서명·최종 URL 생성)

{"command":"listVirtualMachines","params":{"listall":true}}

mold_call

임의 API 호출(command + params)

{"command":"listZones"}

mold_listApisMeta

listApis 메타 조회(name/isasync/params)

{} 또는 {"name":"deployVirtualMachine"}

mold_autoRegisterApis

모든 API를 MCP 툴로 동적 등록

`{"include":"^list

mold_<API명>

자동 등록된 개별 API 툴(예: mold_deployVirtualMachine)

API별 파라미터(아래 표 참고)

자동 등록된 비동기 API(isasync=true)는 _wait, _timeoutMs, _intervalMs 옵션을 추가로 받습니다.

사용 예시

1) 연결정보 설정/확인

// 설정
{"endpoint":"http://10.10.32.10:8080/client/api","apiKey":"...","secret":"...","algo":"sha256","persist":true}

// 조회
{}

2) 기본 조회

// 존 목록
{"command":"listZones"}

// VM 목록
{"command":"listVirtualMachines","params":{"listall":true}}

3) 배포(비동기) — mold_call

입력(JSON):

{
  "command": "deployVirtualMachine",
  "params": {
    "name": "MySQL-Server2",
    "zoneid": "dbbaf9e7-865a-4c89-8a26-338c66ec2b81",
    "details": { "memory": "16384", "cpuNumber": "8" },
    "networkids": "91a24cde-38e4-494a-ae48-778d683ae735",
    "templateid": "ca990e93-f2c0-4367-9f88-5bbc571e9fac",
    "displayname": "MySQL-Server",
    "serviceofferingid": "362c96c7-2b9c-4414-b9ca-9897da845080",
    "boottype": "UEFI"
  }
}

내부 전개(브래킷 표기; 서명 전에 적용):

zoneid=...&serviceofferingid=...&details[0].cpuNumber=8&details[0].memory=16384&
networkids=...&name=MySQL-Server2&templateid=...&displayname=MySQL-Server&boottype=UEFI&
command=deployVirtualMachine

4) 자동 등록된 툴로 바로 호출

// 예: mold_deployVirtualMachine
{
  "serviceofferingid": "362c96c7-2b9c-4414-b9ca-9897da845080",
  "zoneid": "dbbaf9e7-865a-4c89-8a26-338c66ec2b81",
  "templateid": "ca990e93-f2c0-4367-9f88-5bbc571e9fac",
  "name": "MySQL-Server2",
  "details": { "cpuNumber": "8", "memory": "16384" },
  "_wait": true              // 완료까지 폴링
}

파라미터 전개 규칙(브래킷 표기)

입력 타입

예시 입력

전송 형태

원시값

"name":"vm01"

name=vm01

원시 배열

"securitygroupids":["id1","id2"]

securitygroupids=id1,id2 (CSV)

객체(톱레벨)

"details":{"cpuNumber":"8","memory":"16384"}

details[0].cpuNumber=8, details[0].memory=16384

배열-객체

"datadisks":[{"size":"50","diskofferingid":"..."},{"size":"100"}]

datadisks[0].size=50, datadisks[0].diskofferingid=..., datadisks[1].size=100

이미 표기된 키

"details[0].cpuNumber":"8"

그대로 사용

복잡한 중첩 객체도 자동으로 전개됩니다. 이미 details[0].x와 같이 브래킷/닷 표기로 준 키는 수정하지 않습니다.

환경변수

이름

의미

기본

MOLD_ENDPOINT

http(s)://HOST:PORT/client/api

(없음)

MOLD_API_KEY

API 키

(없음)

MOLD_SECRET_KEY

시크릿 키

(없음)

MOLD_SIG_ALGO

sha1 또는 sha256

sha256

MOLD_AUTOREGISTER

"all"이면 시작 시 전체 자동 등록

(비활성)

실행 중에는 mold_setConfig로 변경·저장 가능. 저장 파일: ~/.config/mcp-mold/config.json (파일 권한 0600, 디렉터리 0700)

문제 해결(401 서명 오류 체크리스트)

증상

점검

User signature [...] is not equaled to computed signature [...]

서버/클라 해시 알고리즘 일치(SHA1 vs SHA256), 키·시크릿 공백/개행 제거, 정규화 문자열(소문자·키정렬·값 URL 인코딩·공백 %20) 확인

401 계속

CIDR 제한(api.allowed.source.cidr.list) 또는 권한 문제

일부 API만 실패

파라미터 누락/오타, 권한 부족

mold_signDebug로 normalized/URL을 비교하면 원인을 빨리 찾을 수 있습니다.

보안

  • API/Secret 키는 민감정보입니다. 노출 시 즉시 재발급(회전) 하세요.

  • stdio 모드에선 stdout은 프로토콜 전용, 로그는 stderr만 사용해야 합니다.

라이선스

  • LICENSE 파일을 확인하세요(MIT).

변경 이력(요약)

  • 연결정보 툴 추가(get/set + 디스크 저장)

  • mold_* 네임스페이스로 툴 이름 정규식 대응

  • listApis 기반 자동 도구 등록

  • 비동기 API 폴링 옵션 지원

  • 브래킷 표기 변환기로 중첩 파라미터 처리

  • SHA1/SHA256 서명 알고리즘 토글

Available Tools

11 tools
mold_autoRegisterApisMOLD 모든 API 동적 등록C

listApis를 기반으로 MCP 도구를 일괄 등록합니다. include/exclude는 정규식.

Inputs: include, exclude, limit, namespace.

mold_callMOLD API 호출(범용)C

임의의 MOLD API 명령을 호출합니다. (command + params)

Inputs: command (required), params.

mold_call_debugMOLD API 호출(범용)C

임의의 MOLD API 명령을 호출합니다. (command + params)

Inputs: command (required), params.

mold_getConfigMOLD 연결정보 조회A

현재 사용 중인 endpoint/apiKey(마스킹)/알고리즘/구성파일 경로를 반환합니다.

Inputs: no named parameters.

mold_listApisMetaMOLD listApis 메타 조회C

listApis로부터 API 메타데이터(name, isasync, params)를 조회합니다.

Inputs: name.

mold_listVirtualMachinesVM 목록 조회C

listVirtualMachines(4.21) 호출. 주요 필터만 노출(추가 필드는 mold_call 사용).

Inputs: keyword, id, name, state, +8 more.

mold_setConfigMOLD 연결정보 설정B

endpoint, apiKey, secret 및 서명 알고리즘(sha1|sha256)을 설정합니다. 기본은 sha256. persist=true면 디스크에 저장.

Inputs: endpoint, apiKey, secret, algo, +1 more.

mold_signDebugMOLD 서명/URL 디버그C

정규화 문자열, 서명(Base64), URL 인코딩 서명, 최종 요청 URL을 생성해 점검합니다.

Inputs: command (required), params, includeResponse, apiKeyField.

mold_startVirtualMachineVM 시작C

startVirtualMachine(4.21). 반환에 jobid가 포함될 수 있음(비동기).

Inputs: id (required), hostid, clusterid, podid, +2 more.

mold_stopVirtualMachineVM 정지C

stopVirtualMachine(4.21). forced 옵션 지원. 반환에 jobid 포함 가능.

Inputs: id (required), forced.

mold_waitForJob비동기 잡 완료 대기C

queryAsyncJobResult를 주기적으로 호출하여 완료(1)/실패(2)까지 대기.

Inputs: jobid (required), timeoutMs, intervalMs.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    B3/5.0

    Scored across 11 tools

    Disambiguation3/5

    Most tools have distinct purposes, but there is notable overlap between mold_call and mold_call_debug, which appear to perform the same function with only a debug suffix difference. Additionally, mold_signDebug is similar in purpose to mold_call but focused on debugging signatures, creating some ambiguity in tool selection for debugging-related tasks.

    Naming Consistency4/5

    Tool names follow a consistent mold_verbNoun pattern with snake_case throughout, such as mold_listVirtualMachines and mold_setConfig. The only minor deviation is mold_autoRegisterApis, which uses 'Apis' instead of 'APIs' or a more standard noun form, but overall the naming is highly predictable and readable.

    Tool Count5/5

    With 11 tools, the count is well-scoped for managing MOLD APIs and virtual machines. Each tool serves a clear purpose, from configuration and debugging to VM operations and job monitoring, without feeling excessive or insufficient for the server's domain.

    Completeness4/5

    The toolset provides comprehensive coverage for MOLD API interactions and VM lifecycle management, including configuration, listing, starting, stopping, and job waiting. A minor gap is the lack of tools for updating or deleting configurations or VMs beyond stop, but core workflows are well-supported with workarounds via mold_call.

    Resources

    Related MCP Connectors

    Related MCP Servers