onsense 0.1.0__py3-none-any.whl

onsense/__init__.py

@@ -0,0 +1,14 @@
+"""onSense — 폰을 AI의 눈·센서로 만드는 PC측 MCP 브로커.
+
+서브커맨드: serve(MCP 서버) / pair(페어링+등록) / doctor(진단).
+폰(Android 앱)은 HTTP 제공자, 이 패키지는 stdio MCP 브로커로 AI 클라이언트에 연결한다.
+"""
+
+__version__ = "0.1.0"
+
+# 폰 앱과 합의된 상수 (android: CameraService.PORT / Auth / NSD)
+PHONE_PORT = 8080
+MDNS_TYPE = "_onsense._tcp.local."
+TOKEN_HEADER = "X-Token"
+PAIR_PORT = 8765
+CLIP_PORT = 8770  # 폰→PC 클립보드/파일 데몬 (clip.py). 양방향 GET 도 동일 포트.

onsense/__main__.py

@@ -0,0 +1,7 @@
+"""`python -m onsense ...` 진입점 (콘솔 스크립트 onsense 와 동일)."""
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

onsense/auth.py

@@ -0,0 +1,82 @@
+"""onSense 요청 서명 — 토큰을 평문으로 전송하지 않고 HMAC-SHA256으로 인증·재전송 방지.
+
+서명: HMAC-SHA256(token, f"{METHOD}\\n{path}\\n{ts}\\n{nonce}") → hex
+헤더: X-Ts(유닉스초), X-Nonce(hex), X-Sig(hex). (구 X-Token 평문 전송 폐지)
+검증: ts 윈도(±WINDOW) + nonce 중복 거부(메모리 캐시) + 상수시간 sig 비교.
+
+표준 라이브러리만 사용. 데이터 본문은 여전히 평문(전체 기밀은 추후 TLS) —
+서명은 토큰 도용·요청 위조·replay 를 차단한다. Android Auth.kt 와 동일 규약.
+"""
+import hashlib
+import hmac
+import os
+import time
+
+from . import crypto
+
+WINDOW = 300  # 허용 시계 오차 / replay 윈도(초)
+TS_HEADER = "X-Ts"
+NONCE_HEADER = "X-Nonce"
+SIG_HEADER = "X-Sig"
+ENC_HEADER = "X-Enc"  # 본문 암호화 방식(canonical에 포함 → 스트립/다운그레이드 방지)
+
+
+def _canon(method: str, path: str, ts: str, nonce: str, enc: str) -> bytes:
+    return f"{method.upper()}\n{path}\n{ts}\n{nonce}\n{enc}".encode("utf-8")
+
+
+def sign(token: str, method: str, path: str) -> dict:
+    """요청 1건의 서명 헤더 dict(키=auth_key, X-Enc 포함)."""
+    ts = str(int(time.time()))
+    nonce = os.urandom(16).hex()
+    enc = crypto.ENC
+    sig = hmac.new(crypto.auth_key(token), _canon(method, path, ts, nonce, enc),
+                   hashlib.sha256).hexdigest()
+    return {TS_HEADER: ts, NONCE_HEADER: nonce, SIG_HEADER: sig, ENC_HEADER: enc}
+
+
+class NonceCache:
+    """replay 방지용 nonce 캐시(메모리, 윈도 만료)."""
+
+    def __init__(self, cap: int = 1024):
+        self.cap = cap
+        self._d = {}  # nonce -> 만료시각
+
+    def check_and_add(self, nonce: str, now: int) -> bool:
+        """이미 본 nonce면 True(거부). 처음이면 등록 후 False."""
+        if len(self._d) > self.cap:
+            for k in [k for k, e in self._d.items() if e < now]:
+                self._d.pop(k, None)
+        exp = self._d.get(nonce)
+        if exp is not None and exp >= now:
+            return True
+        self._d[nonce] = now + WINDOW
+        return False
+
+
+def verify(token: str, method: str, path: str, get_header, nonce_cache=None, now=None) -> bool:
+    """서명 검증. get_header(name)->값|None. nonce_cache 주면 replay 거부."""
+    if not token:
+        return False
+    ts = get_header(TS_HEADER)
+    nonce = get_header(NONCE_HEADER)
+    sig = get_header(SIG_HEADER)
+    enc = get_header(ENC_HEADER)
+    if not ts or not nonce or not sig:
+        return False
+    if enc != crypto.ENC:  # 미지정/다운그레이드 거부(하드 컷오버)
+        return False
+    try:
+        tsi = int(ts)
+    except (TypeError, ValueError):
+        return False
+    now = int(time.time()) if now is None else now
+    if abs(now - tsi) > WINDOW:
+        return False
+    expect = hmac.new(crypto.auth_key(token), _canon(method, path, ts, nonce, enc),
+                      hashlib.sha256).hexdigest()
+    if not hmac.compare_digest(sig, expect):
+        return False
+    if nonce_cache is not None and nonce_cache.check_and_add(nonce, now):
+        return False
+    return True

onsense/cli.py

@@ -0,0 +1,87 @@
+"""onsense CLI — serve / pair / doctor 서브커맨드 디스패치."""
+import argparse
+import sys
+
+from . import __version__
+
+try:  # Windows 콘솔 한글/이모지 출력 안전화
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="onsense",
+        description="폰을 AI의 눈·센서로 — PC측 MCP 브로커 (onSense)",
+    )
+    p.add_argument("-V", "--version", action="version",
+                   version=f"onsense {__version__}")
+    sub = p.add_subparsers(dest="cmd", metavar="{pair,doctor,serve,clip}")
+
+    sp = sub.add_parser("serve", help="MCP 서버 실행(stdio). AI 클라이언트가 호출 — pair가 자동 등록")
+    sp.add_argument("--no-clip", action="store_true",
+                    help="폰→PC 클립보드/파일 데몬 자동 기동 안 함")
+
+    cp = sub.add_parser("clip", help="폰↔PC 클립보드/파일 데몬 실행(:8770). serve가 자동 기동하나 단독 실행도 가능")
+    cp.add_argument("--port", type=int, default=None, help="리스닝 포트(기본 8770)")
+    cp.add_argument("--allow-pull", action="store_true",
+                    help="PC 클립보드/복사 파일을 폰이 가져가는 GET /clip 허용(영속 설정 ON)")
+    cp.add_argument("--no-allow-pull", action="store_true",
+                    help="GET /clip 허용을 영속 OFF (실행 중 데몬에도 즉시 반영)")
+    cp.add_argument("--set-clipboard", action="store_true",
+                    help="폰→PC POST 수신 시 OS 클립보드 자동 주입 허용(영속 설정 ON, 파일 저장은 항상 수행)")
+    cp.add_argument("--no-set-clipboard", action="store_true",
+                    help="OS 클립보드 자동 주입을 영속 OFF (실행 중 데몬에도 즉시 반영)")
+
+    pp = sub.add_parser("pair", help="폰과 페어링 + Claude에 MCP 자동 등록")
+    pp.add_argument("uri", nargs="?",
+                    help="onsense://pair?base=...&token=... (생략 시 QR 리스너 모드)")
+    pp.add_argument("--img", metavar="PNG", help="QR 이미지 파일에서 디코드(opencv 필요)")
+    pp.add_argument("--local", action="store_true",
+                    help="개발용: uvx 대신 현재 인터프리터(python -m onsense)로 등록")
+    pp.add_argument("--client", default="claude",
+                    help="MCP 등록 대상 CLI (기본: claude)")
+
+    dp = sub.add_parser("doctor", help="설치/연결 문제 진단 (Python/uv/mcp/Claude/네트워크/폰)")
+    dp.add_argument("--base", help="폰 주소 http://IP:8080 (생략 시 mDNS 자동 탐색)")
+    dp.add_argument("--token", help="폰이 표시하는 페어링 토큰")
+    return p
+
+
+def main(argv=None) -> int:
+    args = build_parser().parse_args(argv)
+    if args.cmd == "serve":
+        if not getattr(args, "no_clip", False):
+            from . import clip
+            clip.spawn_detached()  # 폰→PC 클립보드/파일 데몬 싱글톤 보장(실패해도 serve엔 무영향)
+        from . import server
+        server.main()
+        return 0
+    if args.cmd == "clip":
+        from . import clip
+        # 플래그가 하나라도 지정되면 영속 상태(settings.json)를 먼저 갱신하고 결과를 출력.
+        # 그 뒤 clip.main() 을 호출 — 이미 데몬이 떠 있으면 "already running"으로 종료되지만
+        # 살아있는 데몬이 요청 시점에 영속 설정을 LIVE로 읽으므로 의도대로 반영된다(option ①).
+        allow_pull = True if args.allow_pull else (False if args.no_allow_pull else None)
+        set_clipboard = True if args.set_clipboard else (False if args.no_set_clipboard else None)
+        if allow_pull is not None or set_clipboard is not None:
+            state = clip.save_flags(allow_pull=allow_pull, set_clipboard=set_clipboard)
+            print(f"[clip] 영속 설정 갱신 → pull={'ON' if state['allow_pull'] else 'OFF'}, "
+                  f"set_clipboard={'ON' if state['set_clipboard'] else 'OFF'}")
+        # main() 인자는 영속 승격용(True만 의미); 그 외는 None 처리되어 기존 영속값 유지.
+        return clip.main(args.port or clip.CLIP_PORT,
+                         bool(args.allow_pull), bool(args.set_clipboard))
+    if args.cmd == "pair":
+        from . import pair
+        return pair.main(args)
+    if args.cmd == "doctor":
+        from . import doctor
+        return doctor.main(args)
+    build_parser().print_help()
+    return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())