GrokBot ↔ Obsidian 브리지

Grok Bot 및 기타 호환 MCP 클라이언트가 자체 호스팅 Obsidian 볼트에 도달할 수 있게 해주는 작고 실패 시 차단되는 OAuth 역방향 프록시입니다. 공개 프로세스는 소유자 승인을 종료합니다. 인증된 Streamable HTTP는 루프백 Optimike Obsidian MCP 백엔드로만 전달됩니다.

이 저장소는 기본적으로 standard 도구 프로필과 headless-readonly 런타임을 사용합니다. 실제 볼트, 호스트 이름, 자격 증명, 개인 경로 또는 메모는 포함되어 있지 않습니다.

작동 방식

1. 이 저장소를 클론하고 안내 설치 프로그램을 실행합니다.

2. 설치 프로그램은 공개 Optimike Obsidian MCP v3.0.0을 고정하고 빌드하며, 로컬 venv에 브리지를 설치하고 모드 600 환경 파일을 작성합니다. 프록시를 시작하거나, Optimike를 시작하거나, 볼트를 건드리지 않습니다.

3. 직접 루프백에서 Optimike를 시작한 다음, 루프백에서 이 프록시를 시작하고, 프록시 앞에 HTTPS를 배치합니다.

4. Grok Bot은 OAuth를 발견하고, 클라이언트를 등록하고, 소유자 승인을 기다립니다. PKCE 교환 후 /mcp를 호출합니다. 프록시는 클라이언트 시크릿을 제거하고 세션을 Optimike로 전달합니다.

Optimike 소스는 여기에 벤더링되지 않습니다. docs/UPSTREAM.md를 참조하세요.

Related MCP server: obsidian-vault-mcp

요구 사항

• Python 3.11+

• Node.js 22.7.5+ 및 npm

• git

• 127.0.0.1:8099로 전달되는 공개 HTTPS 호스트 이름

• 설치 프로그램이 태그 v3.0.0(0a40387206a19deb6430f9b61b81fc7a07704717)으로 고정한 Optimike 체크아웃

• 이미 관리 중인 볼트 사본. 이 설치 프로그램은 볼트를 생성, 열기 또는 변경하지 않습니다.

클론 후 한 번의 명령

./scripts/install.sh --non-interactive

스크립트는 root와 sudo를 거부하고, 다운로드를 셸로 파이프하지 않으며, 생성된 소유자 코드를 출력하지 않습니다. 그런 다음 상태를 확인합니다:

python3 scripts/doctor.py

.env.local의 나머지 로컬 볼트 자리 표시자를 채웁니다. headless-readonly, standard, readonly, 프로덕션 JWT 인증 및 생성된 내부 시크릿으로 Optimike를 직접 시작합니다:

set -a
. ./.env.local
set +a
cd .runtime/upstream
NODE_ENV=production MCP_TRANSPORT_TYPE=http MCP_HTTP_HOST=127.0.0.1 \
MCP_HTTP_PORT=3010 MCP_AUTH_MODE=jwt \
MCP_AUTH_SECRET_KEY="$OBSIDIAN_BRIDGE_UPSTREAM_JWT_SECRET" \
node dist/index.js

두 번째 터미널에서 공개 OAuth 프록시를 시작합니다:

.venv/bin/python -m obsidian_bridge serve

GET /health는 {"status":"ok"}를 반환해야 합니다. Python 포트를 직접 노출하지 마십시오.

플러그인 구성

python3 scripts/configure_plugin.py https://mcp.example.com/mcp

생성된 mcp.json 및 .mcp.json에는 공개 URL만 포함됩니다. Authorization 헤더를 추가하지 마십시오. Grok Bot, Codex 및 Cursor는 OAuth 검색 및 PKCE를 사용합니다.

이 브리지 옆에 Composio 추가

Corey Ganim의 Grok Bot 팁은 Composio Connect를 사용하여 클라이언트의 기본 커넥터 카탈로그를 넘어섭니다. Composio는 Connect를 7개의 메타 도구를 통해 1000개 이상의 앱을 위한 하나의 호스팅 MCP 엔드포인트로 설명합니다. 말 그대로 모든 MCP 서버는 아니며, 이 저장소에 번들로 포함되지 않습니다.

두 연결을 분리하여 유지하십시오:

여기의 .grok-plugin, .cursor-plugin 및 .codex-plugin 매니페스트는 읽기 전용 Obsidian 브리지만 설치합니다. Composio 트래픽은 볼트를 통과하지 않으며 Composio는 이 브리지를 대체하지 않습니다. 전체 설정 모델 및 안전 경계는 튜토리얼을 참조하세요.

보안 모델

• DCR, S256 PKCE 및 회전하는 새로 고침 토큰을 사용하는 단일 소유자 OAuth 2.1

• 소유자 코드는 승인 페이지에 필요하며 베어러 토큰이 절대 아님

• 루프백 바인딩; TLS는 이 프로세스 외부에 유지

• 클라이언트 베어러 토큰은 제거되고 Optimike가 요청을 보기 전에 짧은 수명의 별도 서명된 내부 JWT로 대체

• /mcp/full 및 비읽기 전용 모드는 실패 시 차단

• 시크릿은 모드 600 로컬 파일에 유지되고 git, argv 및 stdout에서 제외

엔드포인트를 노출하기 전에 docs/SECURITY.md 및 docs/ARCHITECTURE.md를 읽으십시오.

테스트 및 감사

python3 -m unittest discover -s tests -v
python3 src/privacy_scan.py --root .
python3 scripts/audit_git_history.py

라이선스

이 브리지는 MIT입니다. Optimike Obsidian MCP는 별도의 Apache-2.0 프로젝트로 유지되며 이 트리에 복사되지 않습니다. docs/UPSTREAM.md를 참조하세요.