Skip to main content
Glama
split-beat-he-mcp

split-beat-he-mcp

by CodeKi0303

Split-Beat HE Plugin

codeki lab의 Split-Beat HE 키보드를 ChatGPT Desktop과 Claude Desktop에서 설정하고 진단합니다. 같은 로컬 MCP 서버를 독립 설치해 다른 MCP 클라이언트에 등록할 수도 있습니다.

ChatGPT Desktop에서 설치

저장소 ZIP을 풀고 ChatGPT Desktop에서 해당 폴더를 프로젝트로 엽니다. 앱을 다시 시작한 뒤 Plugins 디렉터리의 Split-Beat HE 마켓플레이스에서 설치합니다. OpenAI 설치 안내.

uvx가 PATH에 있어야 합니다. 첫 실행은 Python 의존성을 준비합니다. CLI를 사용할 경우 아래 두 명령으로 설치합니다.

codex plugin marketplace add CodeKi0303/split-beat-he-plugin --ref v0.1.4
codex plugin add split-beat-he-plugin@split-beat-he

설치한 뒤 Codex의 새 로컬 세션에서 Split-Beat HE를 선택합니다. “키보드 연결 상태와 설치된 펌웨어를 확인해줘”로 시작하세요. 초기 상태는 미연결이며, 장치를 선택하면 리비전과 실제 펌웨어의 지원 기능을 확인합니다. Studio에서 연결 중이면 Studio 연결을 먼저 종료합니다.

Related MCP server: GPT MCP Controller

Claude Desktop에서 설치

  1. 릴리스의 .mcpb 파일을 내려받습니다.

  2. Claude Desktop의 Settings → Desktop app → Extensions → Manage에서 **Advanced settings → Install Extension…**을 선택해 파일을 엽니다. 이전 화면은 Settings → Extensions에서 시작합니다. Claude 설치 안내.

  3. 첫 실행에서 Claude Desktop이 UV로 Python 의존성을 설치합니다. 설치 후 “Split-Beat HE 키보드 연결 상태를 확인해줘”라고 요청합니다.

Windows에서 패키지의 실행 명령과 MCP 응답을 검증했습니다. 번들은 Windows와 macOS를 대상으로 하며, macOS 실기 검증은 남아 있습니다.

독립 MCP 설치

GitHub Releases에서 split_beat_he_mcp-0.1.4-py3-none-any.whl을 내려받아 Python 가상 환경에 설치합니다.

python -m pip install ./split_beat_he_mcp-0.1.4-py3-none-any.whl
split-beat-he-mcp --help

MCP 클라이언트에서 split-beat-he-mcp를 stdio 명령으로 등록합니다. 단독 실행은 읽기 전용으로 시작하며, 설정 변경에는 --write-enabled를 추가합니다. MCP 사용 가이드.

사용 범위

  • 지원 기능은 설치된 펌웨어에서 읽습니다. 구버전은 그 버전에서 지원하는 설정과 진단을 사용할 수 있습니다.

  • 플러그인에서 Hall 보정, Rapid Trigger, 키 매핑, 진단, 프로필, 설정 저장을 사용할 수 있습니다.

  • “왼쪽 Space의 RT를 자동으로 맞춰줘. 축은 3.4mm야”라고 요청하면 손 떼기·손 얹기·반복 입력·길게 누르기를 순서대로 안내합니다. 측정 후 추천값을 RAM에 적용하고 같은 동작으로 재시험할 수 있습니다.

  • 펌웨어 설치는 Studio에서 대상 보드를 확인해 진행합니다. 앱 펌웨어 릴리스는 펌웨어 저장소에서 관리합니다.

빌드

uv와 Node.js를 준비한 뒤 python tools/package_mcp_plugin.py를 실행하면 ZIP, wheel, .mcpb가 dist/에 생성됩니다. 마켓플레이스에 번들되는 wheel도 새로 만들려면 --marketplace를 추가합니다. MIT.

미해제 재입력 허용은 기본 꺼짐이며 지원 펌웨어에서 선택한 Hall 키에 적용할 수 있습니다. 부분 복귀 후 재누름을 해제→눌림으로 보내므로 롱노트를 끊을 수 있습니다. 설정과 측정 제한을 확인하세요.

v0.1.4 매핑 안내

keyboard_layout은 연결한 장치의 현재 키 매핑과 RAM 저장 상태를 읽습니다. 플러그인은 보정·측정 안내에서 현재 매핑 이름을 사용하고, 중복 이름은 좌우와 입력 종류로 구분합니다. 오프라인·데모 기본값 28개는 펌웨어·Studio와 같은 default-bindings.json을 사용합니다. 설치만으로 장치 설정이나 기존 프로필을 변경하지 않습니다.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Turns a real USB HID device — a Raspberry Pi Pico 2 running open-source firmware — into MCP tools (move, click, drag, type, key combos, scroll) for any MCP client. Includes a --mock mode to try every tool with no hardware.
      17
      61 PyPI
      16
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables MCP clients to inspect and control Nooby's modded reanimation script — browsing, validating, creating and deleting dance and moveset modules, switching the active dance/moveset/root mode, tuning themes, keybinds, audio and performance settings, plus backing up and restoring SaveData through 52 tools. An optional executor bridge patch allows live in-game switching rather than only writing settings for the next launch.
      52
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients such as ChatGPT and Claude chats to control a Windows desktop by taking screenshots, moving the mouse, typing text and key chords, focusing windows, reading or writing the clipboard, and launching applications. Access is gated by local approval modes, input kill switches, and an optional authenticated relay for remote clients.
      MIT