ctxgraph 0.5.0__tar.gz → 0.5.2__tar.gz

{ctxgraph-0.5.0 → ctxgraph-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph
-Version: 0.5.0
+Version: 0.5.2
 Summary: 97% cheaper AI coding. ctxgraph builds a knowledge graph of your Python codebase, then generates token-efficient context capsules for any AI tool. Or hook up Ollama/Claude/OpenAI and use it as a code-aware coding assistant — like ChatGPT or Claude Code, but with built-in graph context. Cut token costs by 97%, work offline with just a graph, or connect your favorite LLM.
 Author: ctxgraph contributors
 License: MIT
@@ -508,25 +508,46 @@ ctx info
 
 ### `ctx serve` — MCP server
 
+Start the MCP protocol server for Claude Desktop and other MCP-compatible clients to query the knowledge graph directly.
+
 ```bash
 pip install ctxgraph[mcp]
-ctx serve
+ctx serve --repo /path/to/your/project       # Explicit path (recommended for Claude Desktop)
+ctx serve                                    # Auto-detect from cwd or CTXGRAPH_REPO_PATH
 ```
 
-Claude Desktop config:
+**Claude Desktop config** (use `--repo` or your project path):
 
 ```json
 {
   "mcpServers": {
     "ctxgraph": {
       "command": "ctx",
-      "args": ["serve"]
+      "args": ["serve", "--repo", "C:\\Users\\yourname\\projects\\myapp"]
     }
   }
 }
 ```
 
-Tools: `search_graph`, `get_context_capsule`, `get_file_dependencies`, `get_project_overview`.
+Or set the `CTXGRAPH_REPO_PATH` environment variable instead of passing `--repo`:
+
+```json
+{
+  "mcpServers": {
+    "ctxgraph": {
+      "command": "ctx",
+      "args": ["serve"],
+      "env": {
+        "CTXGRAPH_REPO_PATH": "C:\\Users\\yourname\\projects\\myapp"
+      }
+    }
+  }
+}
+```
+
+Tools: `search_graph`, `get_context_capsule`, `get_file_dependencies`, `get_project_overview`, `read_file`, `search_files`.
+
+> **Windows users:** Claude Desktop may not set the working directory to your project root. Always use `--repo` or `CTXGRAPH_REPO_PATH` to ensure the server can find your graph.
 
 ---
 

{ctxgraph-0.5.0 → ctxgraph-0.5.2}/README.md

@@ -479,25 +479,46 @@ ctx info
 
 ### `ctx serve` — MCP server
 
+Start the MCP protocol server for Claude Desktop and other MCP-compatible clients to query the knowledge graph directly.
+
 ```bash
 pip install ctxgraph[mcp]
-ctx serve
+ctx serve --repo /path/to/your/project       # Explicit path (recommended for Claude Desktop)
+ctx serve                                    # Auto-detect from cwd or CTXGRAPH_REPO_PATH
 ```
 
-Claude Desktop config:
+**Claude Desktop config** (use `--repo` or your project path):
 
 ```json
 {
   "mcpServers": {
     "ctxgraph": {
       "command": "ctx",
-      "args": ["serve"]
+      "args": ["serve", "--repo", "C:\\Users\\yourname\\projects\\myapp"]
     }
   }
 }
 ```
 
-Tools: `search_graph`, `get_context_capsule`, `get_file_dependencies`, `get_project_overview`.
+Or set the `CTXGRAPH_REPO_PATH` environment variable instead of passing `--repo`:
+
+```json
+{
+  "mcpServers": {
+    "ctxgraph": {
+      "command": "ctx",
+      "args": ["serve"],
+      "env": {
+        "CTXGRAPH_REPO_PATH": "C:\\Users\\yourname\\projects\\myapp"
+      }
+    }
+  }
+}
+```
+
+Tools: `search_graph`, `get_context_capsule`, `get_file_dependencies`, `get_project_overview`, `read_file`, `search_files`.
+
+> **Windows users:** Claude Desktop may not set the working directory to your project root. Always use `--repo` or `CTXGRAPH_REPO_PATH` to ensure the server can find your graph.
 
 ---
 

{ctxgraph-0.5.0 → ctxgraph-0.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ctxgraph"
-version = "0.5.0"
+version = "0.5.2"
 description = "97% cheaper AI coding. ctxgraph builds a knowledge graph of your Python codebase, then generates token-efficient context capsules for any AI tool. Or hook up Ollama/Claude/OpenAI and use it as a code-aware coding assistant — like ChatGPT or Claude Code, but with built-in graph context. Cut token costs by 97%, work offline with just a graph, or connect your favorite LLM."
 readme = "README.md"
 license = {text = "MIT"}

{ctxgraph-0.5.0 → ctxgraph-0.5.2}/src/ctxgraph/mcp/server.py

@@ -8,15 +8,27 @@ directly through tools instead of static context capsules.
 Protocol: https://modelcontextprotocol.io
 
 Usage:
-    ctx serve                  # Start MCP server (stdio mode)
-    ctx serve --port 8080      # Start MCP server (SSE mode)
+    ctx serve                                       # Auto-detect from cwd (stdio mode)
+    ctx serve --repo /path/to/project                # Explicit project root
+    ctx serve --port 8080                            # SSE mode (not yet supported)
 
-Claude Desktop config:
+Claude Desktop config (with --repo):
 {
     "mcpServers": {
         "ctxgraph": {
             "command": "ctx",
-            "args": ["serve"]
+            "args": ["serve", "--repo", "C:\\path\\to\\project"]
+        }
+    }
+}
+
+Or via CTXGRAPH_REPO_PATH env var:
+{
+    "mcpServers": {
+        "ctxgraph": {
+            "command": "ctx",
+            "args": ["serve"],
+            "env": {"CTXGRAPH_REPO_PATH": "C:\\path\\to\\project"}
         }
     }
 }
@@ -25,6 +37,7 @@ Claude Desktop config:
 from __future__ import annotations
 
 import json
+import os
 import sys
 from pathlib import Path
 from typing import Any, Optional
@@ -51,11 +64,23 @@ def _find_repo_root(start: Path) -> Path:
     return start
 
 
+def _resolve_repo_path(repo_path: Optional[str] = None) -> Path:
+    if repo_path:
+        return Path(repo_path).resolve()
+    env_path = os.environ.get("CTXGRAPH_REPO_PATH")
+    if env_path:
+        return Path(env_path).resolve()
+    return _find_repo_root(Path.cwd())
+
+
 def create_server(repo_path: Optional[str] = None) -> Optional[Any]:
     if not HAS_MCP:
         return None
 
-    path = Path(repo_path).resolve() if repo_path else _find_repo_root(Path.cwd())
+    path = _resolve_repo_path(repo_path)
+    db_path = path / ".ctxgraph" / "graph.db"
+    print(f"[ctxgraph] Repo root: {path}", file=sys.stderr)
+    print(f"[ctxgraph] Graph DB: {db_path}", file=sys.stderr)
     storage = get_storage(path)
 
     server = Server("ctxgraph")
@@ -124,6 +149,34 @@ def create_server(repo_path: Optional[str] = None) -> Optional[Any]:
                     "properties": {},
                 },
             ),
+            types.Tool(
+                name="read_file",
+                description="Read the full contents of a source file from the repository",
+                inputSchema={
+                    "type": "object",
+                    "properties": {
+                        "file_path": {
+                            "type": "string",
+                            "description": "Path to the file (relative to repo root)",
+                        },
+                    },
+                    "required": ["file_path"],
+                },
+            ),
+            types.Tool(
+                name="search_files",
+                description="Search for files in the repository matching a glob pattern",
+                inputSchema={
+                    "type": "object",
+                    "properties": {
+                        "pattern": {
+                            "type": "string",
+                            "description": "Glob pattern (e.g. '**/*.py', 'src/**/*service*', '**/*test*')",
+                        },
+                    },
+                    "required": ["pattern"],
+                },
+            ),
         ]
 
     @server.call_tool()
@@ -137,7 +190,10 @@ def create_server(repo_path: Optional[str] = None) -> Optional[Any]:
         if storage is None:
             return [types.TextContent(
                 type="text",
-                text="No graph found. Run `ctx build` first.",
+                text=f"No graph found at: {path / '.ctxgraph' / 'graph.db'}\n\n"
+                     f"Run `ctx build` in your project root first.\n"
+                     f"Or set the CTXGRAPH_REPO_PATH environment variable to your project root.\n"
+                     f"Or pass --repo to ctx serve, e.g. `ctx serve --repo /path/to/project`.",
             )]
 
         if name == "search_graph":
@@ -181,6 +237,46 @@ def create_server(repo_path: Optional[str] = None) -> Optional[Any]:
             overview = render_project_overview(storage)
             return [types.TextContent(type="text", text=overview)]
 
+        elif name == "read_file":
+            file_path = arguments.get("file_path", "")
+            full_path = (path / file_path).resolve()
+            if not str(full_path).startswith(str(path.resolve())):
+                return [types.TextContent(
+                    type="text",
+                    text=f"Access denied: {file_path} is outside the repository root.",
+                )]
+            if not full_path.exists():
+                return [types.TextContent(
+                    type="text",
+                    text=f"File not found: {file_path}",
+                )]
+            if not full_path.is_file():
+                return [types.TextContent(
+                    type="text",
+                    text=f"Not a file: {file_path}",
+                )]
+            content = full_path.read_text(encoding="utf-8", errors="replace")
+            lines = content.count("\n") + 1
+            tokens = max(1, len(content) // 4)
+            content += f"\n---\nLine count: {lines} | Tokens: ~{tokens}"
+            return [types.TextContent(type="text", text=content)]
+
+        elif name == "search_files":
+            pattern = arguments.get("pattern", "")
+            matches = sorted(path.rglob(pattern))
+            matches = [m for m in matches if m.is_file()]
+            if not matches:
+                return [types.TextContent(
+                    type="text",
+                    text=f"No files found matching: {pattern}",
+                )]
+            lines = [f"Files matching '{pattern}':", ""]
+            for m in matches[:100]:
+                lines.append(f"  {m.relative_to(path).as_posix()}")
+            if len(matches) > 100:
+                lines.append(f"  ... and {len(matches) - 100} more")
+            return [types.TextContent(type="text", text="\n".join(lines))]
+
         else:
             return [types.TextContent(type="text", text=f"Unknown tool: {name}")]
 

{ctxgraph-0.5.0 → ctxgraph-0.5.2}/src/ctxgraph.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph
-Version: 0.5.0
+Version: 0.5.2
 Summary: 97% cheaper AI coding. ctxgraph builds a knowledge graph of your Python codebase, then generates token-efficient context capsules for any AI tool. Or hook up Ollama/Claude/OpenAI and use it as a code-aware coding assistant — like ChatGPT or Claude Code, but with built-in graph context. Cut token costs by 97%, work offline with just a graph, or connect your favorite LLM.
 Author: ctxgraph contributors
 License: MIT
@@ -508,25 +508,46 @@ ctx info
 
 ### `ctx serve` — MCP server
 
+Start the MCP protocol server for Claude Desktop and other MCP-compatible clients to query the knowledge graph directly.
+
 ```bash
 pip install ctxgraph[mcp]
-ctx serve
+ctx serve --repo /path/to/your/project       # Explicit path (recommended for Claude Desktop)
+ctx serve                                    # Auto-detect from cwd or CTXGRAPH_REPO_PATH
 ```
 
-Claude Desktop config:
+**Claude Desktop config** (use `--repo` or your project path):
 
 ```json
 {
   "mcpServers": {
     "ctxgraph": {
       "command": "ctx",
-      "args": ["serve"]
+      "args": ["serve", "--repo", "C:\\Users\\yourname\\projects\\myapp"]
     }
   }
 }
 ```
 
-Tools: `search_graph`, `get_context_capsule`, `get_file_dependencies`, `get_project_overview`.
+Or set the `CTXGRAPH_REPO_PATH` environment variable instead of passing `--repo`:
+
+```json
+{
+  "mcpServers": {
+    "ctxgraph": {
+      "command": "ctx",
+      "args": ["serve"],
+      "env": {
+        "CTXGRAPH_REPO_PATH": "C:\\Users\\yourname\\projects\\myapp"
+      }
+    }
+  }
+}
+```
+
+Tools: `search_graph`, `get_context_capsule`, `get_file_dependencies`, `get_project_overview`, `read_file`, `search_files`.
+
+> **Windows users:** Claude Desktop may not set the working directory to your project root. Always use `--repo` or `CTXGRAPH_REPO_PATH` to ensure the server can find your graph.
 
 ---