source-context-mcp 0.1.dev6__tar.gz → 0.1.dev8__tar.gz

{source_context_mcp-0.1.dev6 → source_context_mcp-0.1.dev8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: source-context-mcp
-Version: 0.1.dev6
+Version: 0.1.dev8
 Summary: Local Model Context Protocol (MCP) server for Source Context code intelligence.
 Author: Le Ngoc Tu, Dang Huu Hieu, Huynh Phat Tai
 Author-email: Le Ngoc Tu <tuleaibk@gmail.com>, Dang Huu Hieu <danghuuhieu038@gmail.com>, Huynh Phat Tai <huynhphtai@gmail.com>

{source_context_mcp-0.1.dev6 → source_context_mcp-0.1.dev8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "source-context-mcp"
-version = "0.1.dev6"
+version = "0.1.dev8"
 description = "Local Model Context Protocol (MCP) server for Source Context code intelligence."
 readme = "README.md"
 requires-python = ">=3.12"

{source_context_mcp-0.1.dev6 → source_context_mcp-0.1.dev8}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "source-context-mcp"
-version = "0.1.dev6"
+version = "0.1.dev8"
 description = "Local Model Context Protocol (MCP) server for Source Context code intelligence."
 readme = "README.md"
 authors = [

{source_context_mcp-0.1.dev6 → source_context_mcp-0.1.dev8}/src/source_context_mcp/core/settings.py

@@ -84,7 +84,10 @@ def write_settings(settings: Settings):
     """
     CONFIG_DIR.mkdir(parents=True, exist_ok=True)
 
-    data = settings.model_dump(exclude_none=True, mode="json")
+    data = {
+        k: (v.get_secret_value() if hasattr(v, "get_secret_value") else v)
+        for k, v in settings.model_dump(exclude_none=True).items()
+    }
 
     with CONFIG_FILE.open("wb") as f:
         tomli_w.dump(data, f)

{source_context_mcp-0.1.dev6 → source_context_mcp-0.1.dev8}/src/source_context_mcp/server.py

@@ -27,7 +27,9 @@ call.
 
 Resolve scope before calling graph or search tools. Try get_path_settings(path) first if the user is working inside a \
 local checkout; fall back to default_workspace() if no path-specific config exists. Otherwise narrow down with \
-list_workspaces -> list_repositories -> list_branches -> list_projects.
+list_workspaces -> list_repositories. Immediately call get_repository_overview(repository_id) to acquire the full \
+architectural profile (frameworks, tech stack, subprojects, directory map, entrypoints) in one call. Use list_branches \
+and list_projects only if you need a specific branch or subproject ID not already resolved.
 
 Once you have a project_id, use list_files_in_project for file_ids, then get_file_structure before get_file_content \
 when you only need an overview or a node_id - avoid reading full file contents unless necessary.

{source_context_mcp-0.1.dev6 → source_context_mcp-0.1.dev8}/src/source_context_mcp/tools/base.py

@@ -70,3 +70,39 @@ def register_tools(mcp: MCPServer) -> None:
         }
         res = await client.post("/general/projects", req_body)
         return res.result()
+
+    @mcp.tool(
+        description="Get a comprehensive technical overview and architecture summary of a repository in ONE single "
+        "call. Returns summary, primary language, frameworks, tech stack, sub-projects (e.g. backend/frontend), "
+        "key entrypoints, and directory structure map. "
+        "CRITICAL: ALWAYS call this tool FIRST when beginning to explore or analyze any repository, before "
+        "attempting to list files or read directories. This single call gives you the complete architectural "
+        "blueprint and entrypoints, drastically reducing exploratory tool calls and token consumption."
+    )
+    async def get_repository_overview(
+        client: ApiClientDep,
+        repository_id: Annotated[int, Field(description="Repository ID.", ge=1)],
+        workspace_id: Annotated[
+            int | None,
+            Field(
+                default=None,
+                description="Optional Workspace ID. If omitted, resolved across accessible workspaces.",
+                ge=1,
+            ),
+        ] = None,
+        include_readme: Annotated[
+            bool,
+            Field(
+                default=False,
+                description="Whether to include full raw README markdown (default False to conserve tokens).",
+            ),
+        ] = False,
+    ) -> Any:
+        req_body: dict[str, Any] = {
+            "repository_id": repository_id,
+            "include_readme": include_readme,
+        }
+        if workspace_id is not None:
+            req_body["workspace_id"] = workspace_id
+        res = await client.post("/general/repository-overview", req_body)
+        return res.result()

{source_context_mcp-0.1.dev6 → source_context_mcp-0.1.dev8}/src/source_context_mcp/tools/graph.py

@@ -1,4 +1,4 @@
-from typing import Annotated, Any, Literal
+from typing import Annotated, Any
 
 from mcp.server import MCPServer
 from pydantic import Field
@@ -74,3 +74,19 @@ def register_tools(mcp: MCPServer) -> None:
     ) -> Any:
         res = await client.get(f"/graph/nodes/{node_id}/callees")
         return res.result()
+
+    @mcp.tool(description="Find functions, methods and classes in a project that are not referenced anywhere.")
+    async def find_unused_nodes_in_project(
+        client: ApiClientDep,
+        project_id: Annotated[str, Field(description="Project ID.")],
+    ) -> Any:
+        res = await client.get(f"/graph/projects/{project_id}/unused-nodes")
+        return res.result()
+
+    @mcp.tool(description="Find functions, methods and classes in a file that are not referenced anywhere.")
+    async def find_unused_nodes_in_file(
+        client: ApiClientDep,
+        file_id: Annotated[str, Field(description="File ID.")],
+    ) -> Any:
+        res = await client.get(f"/graph/files/{file_id}/unused-nodes")
+        return res.result()