cync-cli 0.4.0__tar.gz → 0.5.0__tar.gz

{cync_cli-0.4.0 → cync_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cync-cli
-Version: 0.4.0
+Version: 0.5.0
 Summary: Sync Claude Code conversations across machines — GitHub-authed CLI + server (Postgres metadata, R2 blobs).
 Project-URL: Homepage, https://github.com/03hgryan/cync
 Project-URL: Repository, https://github.com/03hgryan/cync
@@ -41,10 +41,13 @@ Requires-Dist: typer<1,>=0.12
 Provides-Extra: dev
 Requires-Dist: boto3<2,>=1.34; extra == 'dev'
 Requires-Dist: fastapi<1,>=0.110; extra == 'dev'
+Requires-Dist: mcp>=1.0; extra == 'dev'
 Requires-Dist: pydantic<3,>=2; extra == 'dev'
 Requires-Dist: pytest<9,>=8; extra == 'dev'
 Requires-Dist: ruff>=0.5; extra == 'dev'
 Requires-Dist: uvicorn[standard]<1,>=0.29; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
 Provides-Extra: server
 Requires-Dist: boto3<2,>=1.34; extra == 'server'
 Requires-Dist: fastapi<1,>=0.110; extra == 'server'
@@ -152,6 +155,20 @@ The SvelteKit server holds the token (Supabase SSR cookies); browse at `/p/<proj
 | `cync project list` / `rm <name>` | manage your projects |
 | `cync --version` | print the version |
 
+## MCP server (optional)
+Let Claude (or any MCP host) read your synced conversations *as context* — pull a
+past chat into the model mid-conversation, not just sync files.
+
+```bash
+pipx install 'cync-cli[mcp]'   # the mcp extra
+cync login                     # the server uses your cync session
+```
+Add it to your MCP host (Claude Code `.mcp.json`, Claude Desktop config, etc.):
+```json
+{ "mcpServers": { "cync": { "command": "cync", "args": ["mcp"] } } }
+```
+Tools: `list_projects`, `list_conversations(project)`, `get_conversation(project, id)`.
+
 ## Migrating from v0.2
 If you have v0.2 (static-token) data still in R2, after `cync login`:
 ```bash

{cync_cli-0.4.0 → cync_cli-0.5.0}/README.md

@@ -98,6 +98,20 @@ The SvelteKit server holds the token (Supabase SSR cookies); browse at `/p/<proj
 | `cync project list` / `rm <name>` | manage your projects |
 | `cync --version` | print the version |
 
+## MCP server (optional)
+Let Claude (or any MCP host) read your synced conversations *as context* — pull a
+past chat into the model mid-conversation, not just sync files.
+
+```bash
+pipx install 'cync-cli[mcp]'   # the mcp extra
+cync login                     # the server uses your cync session
+```
+Add it to your MCP host (Claude Code `.mcp.json`, Claude Desktop config, etc.):
+```json
+{ "mcpServers": { "cync": { "command": "cync", "args": ["mcp"] } } }
+```
+Tools: `list_projects`, `list_conversations(project)`, `get_conversation(project, id)`.
+
 ## Migrating from v0.2
 If you have v0.2 (static-token) data still in R2, after `cync login`:
 ```bash

{cync_cli-0.4.0 → cync_cli-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cync-cli"
-version = "0.4.0"
+version = "0.5.0"
 description = "Sync Claude Code conversations across machines — GitHub-authed CLI + server (Postgres metadata, R2 blobs)."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -34,8 +34,12 @@ server = [
     "boto3>=1.34,<2",
     "pydantic>=2,<3",
 ]
+mcp = [
+    "mcp>=1.0",
+]
 dev = [
     "cync-cli[server]",
+    "cync-cli[mcp]",
     "pytest>=8,<9",
     "ruff>=0.5",
 ]

{cync_cli-0.4.0 → cync_cli-0.5.0}/src/cync/__init__.py

@@ -1,3 +1,3 @@
 """cync — sync Claude Code conversations across machines."""
 
-__version__ = "0.4.0"
+__version__ = "0.5.0"

{cync_cli-0.4.0 → cync_cli-0.5.0}/src/cync/client.py

@@ -416,6 +416,19 @@ def install_hooks(
     console.print("  · last-writer-wins; run [bold]cync install-hooks --uninstall[/] to remove")
 
 
+@app.command(name="mcp")
+def mcp_cmd() -> None:
+    """Run the cync MCP server (stdio) so MCP hosts can read your conversations."""
+    import sys
+
+    try:
+        from .mcp_server import run
+    except ImportError:
+        print("MCP support not installed — run: pipx install 'cync-cli[mcp]'", file=sys.stderr)
+        raise typer.Exit(1)
+    run()
+
+
 # ---- project management ----
 
 

cync_cli-0.5.0/src/cync/mcp_server.py

@@ -0,0 +1,132 @@
+"""cync MCP server — expose your synced conversations to MCP hosts.
+
+Run via `cync mcp` (stdio). Authenticates with your cync session (from
+`cync login`) and calls the cync API, so an MCP host (Claude Desktop, Claude
+Code, etc.) can read your conversations across machines as retrievable context.
+"""
+from __future__ import annotations
+
+import base64
+import json
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+from . import auth, common
+from .config import ClientConfig
+
+mcp = FastMCP("cync")
+
+_MAX_CHARS = 30000  # cap transcript size returned to the model
+
+
+def _request(method: str, path: str, **kw) -> httpx.Response:
+    session = auth.load_session()
+    if not session:
+        raise RuntimeError("not signed in — run `cync login` in a terminal first")
+    server = ClientConfig.load().server_url
+    headers = {"Authorization": f"Bearer {session.access_token}"}
+    r = httpx.request(method, server + path, headers=headers, timeout=60.0, **kw)
+    if r.status_code == 401:
+        session = auth.refresh(session)
+        headers["Authorization"] = f"Bearer {session.access_token}"
+        r = httpx.request(method, server + path, headers=headers, timeout=60.0, **kw)
+    r.raise_for_status()
+    return r
+
+
+def _resolve_project(project: str) -> dict:
+    slug = common.slugify_project(project)
+    for p in _request("GET", "/projects").json():
+        if p.get("slug") == slug:
+            return p
+    raise ValueError(f"no project '{project}' — call list_projects() to see what's available")
+
+
+def _render(jsonl_text: str) -> str:
+    out: list[str] = []
+    for line in jsonl_text.splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            o = json.loads(line)
+        except Exception:
+            continue
+        typ = o.get("type")
+        if typ == "summary" and o.get("summary"):
+            out.append(f"[summary] {o['summary']}")
+            continue
+        if typ not in ("user", "assistant"):
+            continue
+        content = (o.get("message") or {}).get("content")
+        text = ""
+        if isinstance(content, str):
+            text = content
+        elif isinstance(content, list):
+            parts = []
+            for p in content:
+                if not isinstance(p, dict):
+                    continue
+                if p.get("type") == "text":
+                    parts.append(p.get("text", ""))
+                elif p.get("type") == "tool_use":
+                    parts.append(f"[tool: {p.get('name', '')}]")
+                elif p.get("type") == "tool_result":
+                    parts.append("[tool result]")
+            text = "\n".join(x for x in parts if x)
+        if text.strip() and not text.startswith("<"):
+            out.append(f"{typ}: {text}")
+    return "\n\n".join(out)
+
+
+@mcp.tool()
+def list_projects() -> list[dict]:
+    """List your cync projects (name, slug, and conversation count)."""
+    return [
+        {"slug": p["slug"], "name": p.get("name", ""), "conversations": p.get("count", 0)}
+        for p in _request("GET", "/projects").json()
+    ]
+
+
+@mcp.tool()
+def list_conversations(project: str) -> list[dict]:
+    """List conversations in a project (by slug): id, title, and updated time."""
+    proj = _resolve_project(project)
+    convs = _request("GET", f"/projects/{proj['id']}/conversations").json()
+    return [
+        {"id": c["id"], "title": c.get("title", ""), "updated": c.get("updated_at", "")}
+        for c in convs
+    ]
+
+
+@mcp.tool()
+def get_conversation(project: str, conversation_id: str) -> str:
+    """Fetch a past conversation's transcript as readable text, to use as context.
+
+    `project` is a slug; `conversation_id` is a full id or an unambiguous prefix.
+    """
+    proj = _resolve_project(project)
+    convs = _request("GET", f"/projects/{proj['id']}/conversations").json()
+    matches = [c["id"] for c in convs if c["id"].startswith(conversation_id)]
+    if not matches:
+        raise ValueError(f"no conversation matching '{conversation_id}'")
+    if len(matches) > 1:
+        raise ValueError(f"'{conversation_id}' is ambiguous ({len(matches)} matches)")
+    d = _request("GET", f"/projects/{proj['id']}/conversations/{matches[0]}").json()
+    text = _render(base64.b64decode(d["content_b64"]).decode("utf-8", "ignore"))
+    if len(text) > _MAX_CHARS:
+        text = "…(earlier messages truncated)…\n\n" + text[-_MAX_CHARS:]
+    return text or "(no renderable content)"
+
+
+def run() -> None:
+    """Run the stdio MCP server (used by `cync mcp`).
+
+    Silence per-request httpx logs — in stdio mode stdout must be a clean
+    JSON-RPC stream (the mcp SDK sends its own logs to stderr).
+    """
+    import logging
+
+    logging.getLogger("httpx").setLevel(logging.WARNING)
+    mcp.run()