source-context-mcp 0.1.dev7__py3-none-any.whl → 0.1.dev8__py3-none-any.whl

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/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/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()

{source_context_mcp-0.1.dev7.dist-info → source_context_mcp-0.1.dev8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: source-context-mcp
-Version: 0.1.dev7
+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.dev7.dist-info → source_context_mcp-0.1.dev8.dist-info}/RECORD

@@ -13,13 +13,13 @@ source_context_mcp/prompts/prepare_for_change.py,sha256=VtNDg3_fcxB7wVKT0prfQAvz
 source_context_mcp/prompts/summarize_file.py,sha256=Kz1B2z1d0GU8erZT3MoJAUrwtznuCn0frXXn3N5C1iY,1388
 source_context_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 source_context_mcp/resources/__init__.py,sha256=L04VxdEkuJfA6DeIcrWRNUGGGizG2-FN9vDCgEkEMR8,165
-source_context_mcp/server.py,sha256=EXma_1nC1J6EFshKSCBPxSLZYCJK58H5F6XLyoB5Emg,4113
+source_context_mcp/server.py,sha256=PgCReFTAfGHd18mRoJPi8h4du6bbUBKkx3pcV7E71pE,4370
 source_context_mcp/tools/__init__.py,sha256=S-Hc3nVG6pOhhHrWH9754KLSJbjaxB81qET6-K_47W8,559
-source_context_mcp/tools/base.py,sha256=uR4TInXQLd9EHbBncLgxRV4yK8E6k8j13c7dX4gO3Ak,2914
+source_context_mcp/tools/base.py,sha256=kgqwUf2eh3kbudU_cXm6KysgLVQ6DJSzfoSZMbrBzLQ,4555
 source_context_mcp/tools/debug.py,sha256=Uxa65hGux-On3mTh_xIKGqsYqFLf9a-IHl4YV61_RKo,889
-source_context_mcp/tools/graph.py,sha256=u67pBZHQh3cbwxmFs80hZtVIZ8iYvz7bIytzxmhi-IU,2775
+source_context_mcp/tools/graph.py,sha256=zBqz3MNbyqOhiScEwvLYOJtgd0ZZm8we-Xlw9ORc19c,3500
 source_context_mcp/tools/vector.py,sha256=kNWVioxXRqSfcjIWhUg5KkA9T9lp1eh3S1XTfplZnP0,1568
-source_context_mcp-0.1.dev7.dist-info/WHEEL,sha256=lrO5MD1WVAWzcbNy_L2BwtfPrcM3KfUFpbKYXLkJX4A,80
-source_context_mcp-0.1.dev7.dist-info/entry_points.txt,sha256=6GHRs5Gjv4LDEnJMY3Vc4_xny6ztzsDCyUQJh0bOoVc,63
-source_context_mcp-0.1.dev7.dist-info/METADATA,sha256=zzc1FT8gQFdQtp4BgN4mNNaLvSMwCNJT1Xa-6GErnTs,9703
-source_context_mcp-0.1.dev7.dist-info/RECORD,,
+source_context_mcp-0.1.dev8.dist-info/WHEEL,sha256=y6e-a5KI2W-qDAJKfh9Xr81bin8NgUdfWgz3VSXXpe4,80
+source_context_mcp-0.1.dev8.dist-info/entry_points.txt,sha256=6GHRs5Gjv4LDEnJMY3Vc4_xny6ztzsDCyUQJh0bOoVc,63
+source_context_mcp-0.1.dev8.dist-info/METADATA,sha256=WeqGaJ5tJVXKkwy8gnwZJHRvl11HALCgDhGXpOlsVE4,9703
+source_context_mcp-0.1.dev8.dist-info/RECORD,,

{source_context_mcp-0.1.dev7.dist-info → source_context_mcp-0.1.dev8.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.12.1
+Generator: uv 0.12.9
 Root-Is-Purelib: true
 Tag: py3-none-any