mimir-server-client 1.0.0__tar.gz

mimir_server_client-1.0.0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: mimir-server-client
+Version: 1.0.0
+Summary: Lightweight MCP proxy client for remote Mimir context servers — no repos, no models, no indexing needed
+License: MIT
+Project-URL: Homepage, https://github.com/repfly/mimir
+Project-URL: Repository, https://github.com/repfly/mimir
+Project-URL: Issues, https://github.com/repfly/mimir/issues
+Keywords: mcp,context,code,llm,proxy,mimir
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: typer>=0.9
+
+# mimir-client
+
+Lightweight MCP proxy client for remote [Mimir](https://github.com/repfly/mimir) context servers.
+
+No repos, no models, no indexing needed. Just point at a running Mimir HTTP server and get instant MCP access in your IDE.
+
+## Install
+
+```bash
+pipx install mimir-client
+```
+
+## Usage
+
+### MCP proxy (for IDE integration)
+
+```bash
+mimir-client serve http://your-server:8421
+```
+
+Configure your IDE's MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "mimir": {
+      "command": "mimir-client",
+      "args": ["serve", "http://your-server:8421"]
+    }
+  }
+}
+```
+
+### Health check
+
+```bash
+mimir-client health http://your-server:8421
+```
+
+## How it works
+
+`mimir-client` runs a local MCP stdio server that proxies all requests to a remote Mimir HTTP server. This lets developers use Mimir without needing the full server, repo access, or GPU for embeddings.
+
+## License
+
+MIT

mimir_server_client-1.0.0/README.md

@@ -0,0 +1,46 @@
+# mimir-client
+
+Lightweight MCP proxy client for remote [Mimir](https://github.com/repfly/mimir) context servers.
+
+No repos, no models, no indexing needed. Just point at a running Mimir HTTP server and get instant MCP access in your IDE.
+
+## Install
+
+```bash
+pipx install mimir-client
+```
+
+## Usage
+
+### MCP proxy (for IDE integration)
+
+```bash
+mimir-client serve http://your-server:8421
+```
+
+Configure your IDE's MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "mimir": {
+      "command": "mimir-client",
+      "args": ["serve", "http://your-server:8421"]
+    }
+  }
+}
+```
+
+### Health check
+
+```bash
+mimir-client health http://your-server:8421
+```
+
+## How it works
+
+`mimir-client` runs a local MCP stdio server that proxies all requests to a remote Mimir HTTP server. This lets developers use Mimir without needing the full server, repo access, or GPU for embeddings.
+
+## License
+
+MIT

mimir_server_client-1.0.0/mimir_client/__init__.py

@@ -0,0 +1,3 @@
+"""Mimir Client — thin MCP proxy for remote Mimir context servers."""
+
+__version__ = "1.0.0"

mimir_server_client-1.0.0/mimir_client/cli.py

@@ -0,0 +1,83 @@
+"""Minimal CLI for the Mimir remote proxy client."""
+
+from __future__ import annotations
+
+import logging
+import sys
+
+import typer
+
+app = typer.Typer(
+    name="mimir-client",
+    help="Mimir Client — connect your IDE to a remote Mimir context server.",
+    no_args_is_help=True,
+)
+
+
+@app.command()
+def serve(
+    remote: str = typer.Argument(
+        ...,
+        help="URL of the remote Mimir HTTP server (e.g. http://team-server:8421)",
+    ),
+    verbose: bool = typer.Option(False, "--verbose", "-v", help="Enable debug logging"),
+) -> None:
+    """Start a local MCP proxy that forwards to a remote Mimir server.
+
+    Your IDE connects to this proxy via stdio. All queries are forwarded
+    to the remote HTTP server over the network.
+
+    \b
+    Example:
+      mimir-client serve http://team-server:8421
+    """
+    level = logging.DEBUG if verbose else logging.INFO
+    logging.basicConfig(
+        level=level,
+        format="%(asctime)s %(levelname)-8s %(name)s — %(message)s",
+        datefmt="%H:%M:%S",
+        stream=sys.stderr,
+    )
+
+    from mimir_client.proxy import run_remote_mcp
+    run_remote_mcp(remote)
+
+
+@app.command()
+def health(
+    remote: str = typer.Argument(
+        ...,
+        help="URL of the remote Mimir HTTP server (e.g. http://team-server:8421)",
+    ),
+) -> None:
+    """Check if a remote Mimir server is reachable and show its status."""
+    import asyncio
+
+    async def _check():
+        import aiohttp
+        url = remote.rstrip("/") + "/api/v1/health"
+        try:
+            async with aiohttp.ClientSession() as session:
+                async with session.get(url, timeout=aiohttp.ClientTimeout(total=5)) as resp:
+                    if resp.status == 200:
+                        data = await resp.json()
+                        typer.echo(f"Status:     {data.get('status', '?')}")
+                        typer.echo(f"Workspace:  {data.get('workspace', '?')}")
+                        typer.echo(f"Nodes:      {data.get('graph_nodes', '?')}")
+                        typer.echo(f"Edges:      {data.get('graph_edges', '?')}")
+                    else:
+                        typer.echo(f"Server returned HTTP {resp.status}", err=True)
+                        raise typer.Exit(1)
+        except aiohttp.ClientError as exc:
+            typer.echo(f"Cannot reach server: {exc}", err=True)
+            raise typer.Exit(1)
+
+    asyncio.run(_check())
+
+
+def main():
+    app()
+
+
+if __name__ == "__main__":
+    main()

mimir_server_client-1.0.0/mimir_client/proxy.py

@@ -0,0 +1,138 @@
+"""Thin MCP stdio proxy that forwards to a remote Mimir HTTP server.
+
+This is what developers use in their IDE config when they don't have
+repos cloned locally.  It reads JSON-RPC from stdin, POSTs to the
+remote HTTP ``/api/v1/mcp`` endpoint, and writes the response back
+to stdout.
+
+No local repos, no local index, no local embedding model required.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import json
+import logging
+import sys
+
+logger = logging.getLogger(__name__)
+
+
+def run_remote_mcp(remote_url: str) -> None:
+    """Start a local MCP stdio server that proxies to a remote Mimir HTTP server.
+
+    Parameters
+    ----------
+    remote_url:
+        Base URL of the remote Mimir HTTP server, e.g. ``http://team-server:8421``.
+    """
+    remote_url = remote_url.rstrip("/")
+    mcp_endpoint = f"{remote_url}/api/v1/mcp"
+    health_endpoint = f"{remote_url}/api/v1/health"
+
+    logger.info("Remote MCP proxy starting — forwarding to %s", mcp_endpoint)
+
+    async def _check_health() -> bool:
+        """Verify the remote server is reachable before entering the main loop."""
+        try:
+            import aiohttp
+            async with aiohttp.ClientSession() as session:
+                async with session.get(health_endpoint, timeout=aiohttp.ClientTimeout(total=5)) as resp:
+                    if resp.status == 200:
+                        data = await resp.json()
+                        logger.info(
+                            "Remote server OK — workspace=%s, nodes=%s",
+                            data.get("workspace", "?"),
+                            data.get("graph_nodes", "?"),
+                        )
+                        return True
+                    else:
+                        logger.error("Remote server returned HTTP %d", resp.status)
+                        return False
+        except Exception as exc:
+            logger.error("Cannot reach remote server at %s: %s", remote_url, exc)
+            return False
+
+    async def _forward_request(rpc_request: dict) -> dict:
+        """POST a JSON-RPC request to the remote server and return the response."""
+        import aiohttp
+
+        try:
+            async with aiohttp.ClientSession() as session:
+                async with session.post(
+                    mcp_endpoint,
+                    json=rpc_request,
+                    timeout=aiohttp.ClientTimeout(total=60),
+                ) as resp:
+                    if resp.status == 200:
+                        return await resp.json()
+                    else:
+                        body = await resp.text()
+                        logger.error("Remote error HTTP %d: %s", resp.status, body[:200])
+                        return {
+                            "jsonrpc": "2.0",
+                            "id": rpc_request.get("id"),
+                            "error": {
+                                "code": -32000,
+                                "message": f"Remote server error: HTTP {resp.status}",
+                            },
+                        }
+        except asyncio.TimeoutError:
+            return {
+                "jsonrpc": "2.0",
+                "id": rpc_request.get("id"),
+                "error": {"code": -32000, "message": "Remote server timeout"},
+            }
+        except Exception as exc:
+            logger.error("Forward failed: %s", exc)
+            return {
+                "jsonrpc": "2.0",
+                "id": rpc_request.get("id"),
+                "error": {"code": -32000, "message": f"Connection failed: {exc}"},
+            }
+
+    async def main_loop():
+        """Read JSON-RPC from stdin, forward to remote, write response to stdout."""
+        if not await _check_health():
+            logger.error("Exiting — remote server is not reachable")
+            sys.exit(1)
+
+        reader = asyncio.StreamReader()
+        protocol = asyncio.StreamReaderProtocol(reader)
+        await asyncio.get_event_loop().connect_read_pipe(lambda: protocol, sys.stdin)
+
+        loop = asyncio.get_event_loop()
+        write_transport, _ = await loop.connect_write_pipe(
+            asyncio.streams.FlowControlMixin, sys.stdout,
+        )
+
+        buffer = b""
+        while True:
+            try:
+                data = await reader.read(4096)
+                if not data:
+                    break
+                buffer += data
+
+                while b"\n" in buffer:
+                    line, buffer = buffer.split(b"\n", 1)
+                    line = line.strip()
+                    if not line:
+                        continue
+                    try:
+                        request = json.loads(line)
+                        response = await _forward_request(request)
+                        if response and response.get("id") is not None:
+                            out = json.dumps(response) + "\n"
+                            write_transport.write(out.encode())
+                    except json.JSONDecodeError:
+                        continue
+            except asyncio.CancelledError:
+                break
+            except Exception as exc:
+                logger.error("Proxy loop error: %s", exc, exc_info=True)
+
+    try:
+        asyncio.run(main_loop())
+    except KeyboardInterrupt:
+        pass

mimir_server_client-1.0.0/mimir_server_client.egg-info/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: mimir-server-client
+Version: 1.0.0
+Summary: Lightweight MCP proxy client for remote Mimir context servers — no repos, no models, no indexing needed
+License: MIT
+Project-URL: Homepage, https://github.com/repfly/mimir
+Project-URL: Repository, https://github.com/repfly/mimir
+Project-URL: Issues, https://github.com/repfly/mimir/issues
+Keywords: mcp,context,code,llm,proxy,mimir
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: typer>=0.9
+
+# mimir-client
+
+Lightweight MCP proxy client for remote [Mimir](https://github.com/repfly/mimir) context servers.
+
+No repos, no models, no indexing needed. Just point at a running Mimir HTTP server and get instant MCP access in your IDE.
+
+## Install
+
+```bash
+pipx install mimir-client
+```
+
+## Usage
+
+### MCP proxy (for IDE integration)
+
+```bash
+mimir-client serve http://your-server:8421
+```
+
+Configure your IDE's MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "mimir": {
+      "command": "mimir-client",
+      "args": ["serve", "http://your-server:8421"]
+    }
+  }
+}
+```
+
+### Health check
+
+```bash
+mimir-client health http://your-server:8421
+```
+
+## How it works
+
+`mimir-client` runs a local MCP stdio server that proxies all requests to a remote Mimir HTTP server. This lets developers use Mimir without needing the full server, repo access, or GPU for embeddings.
+
+## License
+
+MIT

mimir_server_client-1.0.0/mimir_server_client.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+mimir_client/__init__.py
+mimir_client/cli.py
+mimir_client/proxy.py
+mimir_server_client.egg-info/PKG-INFO
+mimir_server_client.egg-info/SOURCES.txt
+mimir_server_client.egg-info/dependency_links.txt
+mimir_server_client.egg-info/entry_points.txt
+mimir_server_client.egg-info/requires.txt
+mimir_server_client.egg-info/top_level.txt

mimir_server_client-1.0.0/mimir_server_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mimir_server_client-1.0.0/mimir_server_client.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mimir-client = mimir_client.cli:main

mimir_server_client-1.0.0/mimir_server_client.egg-info/requires.txt

@@ -0,0 +1,2 @@
+aiohttp>=3.9
+typer>=0.9

mimir_server_client-1.0.0/mimir_server_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+mimir_client

mimir_server_client-1.0.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel>=0.46"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mimir-server-client"
+version = "1.0.0"
+description = "Lightweight MCP proxy client for remote Mimir context servers — no repos, no models, no indexing needed"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+keywords = ["mcp", "context", "code", "llm", "proxy", "mimir"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Documentation",
+]
+
+dependencies = [
+    "aiohttp>=3.9",
+    "typer>=0.9",
+]
+
+[project.urls]
+Homepage = "https://github.com/repfly/mimir"
+Repository = "https://github.com/repfly/mimir"
+Issues = "https://github.com/repfly/mimir/issues"
+
+[project.scripts]
+mimir-client = "mimir_client.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["mimir_client*"]

mimir_server_client-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+