grok-bot-mcp

Grok Bot용 MCP 서버 — 모든 AI 에이전트가 여러분의 봇을 제어할 수 있게 해줍니다.

봇 생성, 대화 기록 읽기, 메시지 전송, 기록 검색, 사용량 확인 — 모두 Model Context Protocol을 통해 가능합니다. Claude Desktop, Cursor, Windsurf, Cline, VS Code Copilot 및 모든 MCP 호환 클라이언트에서 작동합니다.

함께 사용하기: gbu — Grok Bot 사용량 확인 도구

이 프로젝트가 하는 일

grok-bot-mcp는 AI 에이전트(Claude, Cursor, Copilot 등)를 로컬에서 실행 중인 Grok Bot 인스턴스에 연결해주는 MCP 서버입니다. 설치 후에는 모든 MCP 호환 AI 클라이언트가 다음을 할 수 있습니다:

• 봇 생성, 목록 조회, 검색, 삭제 — Grok Bot 앱을 열지 않고도 가능

• 봇에 메시지 전송 및 응답 수신 — AI 편집기에서 직접 가능

• 대화 기록 읽기 — 모든 봇의 전체 히스토리

• 모든 봇 메시지 검색 — 로컬 데이터베이스 전체 텍스트 검색

• 사용량 및 결제 확인 — 주간 사용량 %, 온디맨드 지출, 리셋 시간

• 로컬 데이터베이스 목록 조회 — 모든 에이전트 store.db 파일과 크기 확인

이 모든 것이 표준화된 MCP 도구 인터페이스를 통해 제공됩니다. 별도의 커스텀 API 통합이 필요 없습니다.

Related MCP server: Grok MCP

설치

한 줄 명령 (macOS / Linux):

gh repo clone Kargatharaakash/grok-bot-mcp && cd grok-bot-mcp && sh install.sh

설치 스크립트는 설치된 AI 에이전트를 자동으로 감지하여 각각에 대해 MCP 서버를 구성합니다. 설치 후 AI 에이전트를 재시작하세요.

구성되는 항목:

도구

MCP 서버는 연결된 모든 AI 에이전트에게 다음 도구를 제공합니다:

에이전트 관리

메시징

데이터베이스

사용량

작동 방식

AI Agent (Claude / Cursor / Copilot / Windsurf / etc.)
        │
        │ MCP Protocol (JSON-RPC over stdio)
        ▼
   grok-bot-mcp server
        │
        ├── Grok Bot Gateway ──► http://127.0.0.1:<port>/api/<command>
        │                          ├── listAgents, createAgent, sendPrompt...
        │                          └── 100+ gateway commands
        │
        ├── Local SQLite DBs ──► ~/.grokbot/agents/<id>/store.db (read-only)
        │                          └── transcript_entries, kv, blobs
        │
        └── Cursor Usage API ─► api2.cursor.sh (ConnectRPC)
                                   └── GetSandUsageStatus, GetCurrentPeriodUsage

서버는 gateway-descriptor.json을 복호화하여 Grok Bot 게이트웨이를 발견합니다(gbu와 동일한 macOS Keychain 기법). 데이터베이스 쿼리의 경우 로컬 SQLite 파일을 읽기 전용 모드로 직접 읽습니다.

수동 구성

수동으로 구성하려면 MCP 구성 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "grok-bot": {
      "command": "node",
      "args": ["~/.gbm/bin/grok-bot-mcp"]
    }
  }
}

요구 사항

• Node.js 18+

• Grok Bot 앱 설치 및 실행 중 (게이트웨이 및 키체인 접근용)

• macOS (게이트웨이 발견 및 키체인 복호화용; 파일이 존재하면 데이터베이스 읽기는 모든 OS에서 작동)

테스트

테스트는 목(mock)을 사용합니다 — 실제 Grok Bot 호출, 네트워크, 데이터베이스 쓰기 없음:

node --test tests/*.test.mjs

보안

• 읽기 전용 데이터베이스 접근 — 모든 SQLite 쿼리에 PRAGMA query_only = 1 적용

• MCP 응답에 비밀 정보 없음 — 토큰은 AI 에이전트에게 절대 반환되지 않음

• 게이트웨이 토큰은 시작 시 복호화 — 디스크에 절대 기록되지 않음

• 로컬 전용 — stdio 전송, 네트워크 서버 노출 없음

• 텔레메트리 없음 — 127.0.0.1(게이트웨이) 및 api2.cursor.sh(사용량) 외에는 호출 없음

제거

rm -rf ~/.gbm

그런 다음 AI 에이전트의 MCP 구성 파일에서 grok-bot 항목을 제거하세요.

함께 보기

gbu — Grok Bot 사용량 확인 CLI. 터미널에서 다중 계정 사용량 확인 가능. 동일한 토큰 관리, 동일한 API, 다른 인터페이스(CLI vs MCP).

라이선스

MIT

#GrokBot #MCP #ModelContextProtocol #Cursor #Claude #AI #DeveloperTools #Automation

⭐ 이 프로젝트가 여러분의 AI 에이전트가 봇을 제어할 수 있게 해주었다면 스타를 눌러주세요.

면책 조항

이 프로젝트는 학습 및 연구 목적으로 만들어진 독립적인 교육용 도구입니다. Cursor, Anysphere, Grok, Grok Bot, SpaceXAI, xAI, SpaceX 또는 기타 회사, 제품, 단체와 제휴, 보증, 후원 또는 관련이 없습니다.

이 저장소에 언급된 모든 제품 이름, 로고, 상표 및 등록 상표는 해당 소유자의 자산입니다. 이름이나 로고의 사용은 식별 및 교육적 참고용일 뿐이며, 보증, 파트너십 또는 제휴를 의미하지 않습니다.

이 도구는 로컬에서 실행 중인 애플리케이션과 공개적으로 접근 가능한 API 엔드포인트를, 사용자가 이미 보유한 자격 증명을 사용하여 상호 작용합니다. 인증을 우회하거나, 보호된 콘텐츠를 스크래핑하거나, 비공개 시스템에 접근하지 않습니다. 이 도구와 함께 사용하는 모든 플랫폼의 서비스 약관을 준수할 책임은 전적으로 사용자에게 있습니다.

이 프로젝트의 작성자와 기여자는 이 소프트웨어 사용으로 인해 발생하는 손해, 계정 조치 또는 결과에 대해 어떠한 책임도 지지 않습니다. 사용에 따른 판단은 사용자의 책임입니다.