contextlayer-mcp-server 0.1.0__tar.gz

contextlayer_mcp_server-0.1.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: contextlayer-mcp-server
+Version: 0.1.0
+Summary: Invisible intelligence layer for AI coding tools (MCP)
+Author: Rudra Nalawade
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.0.0

contextlayer_mcp_server-0.1.0/contextlayer/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

contextlayer_mcp_server-0.1.0/contextlayer/detection.py

@@ -0,0 +1,186 @@
+"""Filesystem detection for ContextLayer. Pure functions, no MCP coupling."""
+from __future__ import annotations
+
+import json
+import os
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Iterable
+
+MAX_SCAN_DEPTH = 3
+MAX_FILES_READ = 40
+MAX_BYTES_PER_FILE = 8 * 1024
+
+IGNORE_DIRS = {
+    ".git", "node_modules", "venv", ".venv", "__pycache__",
+    "dist", "build", ".next", "target", "vendor", ".mypy_cache",
+    ".pytest_cache", "coverage", ".idea", ".vscode",
+}
+
+LANGUAGE_MARKERS = {
+    "package.json": "Node.js",
+    "tsconfig.json": "TypeScript",
+    "go.mod": "Go",
+    "requirements.txt": "Python",
+    "pyproject.toml": "Python",
+    "Cargo.toml": "Rust",
+    "pom.xml": "Java (Maven)",
+    "build.gradle": "Java/Kotlin (Gradle)",
+    "Gemfile": "Ruby",
+    "composer.json": "PHP",
+}
+
+SOURCE_EXTS = {
+    ".py", ".ts", ".tsx", ".js", ".jsx", ".go", ".rs",
+    ".java", ".kt", ".rb", ".php",
+}
+
+STYLE_MARKERS = {
+    ".prettierrc": "prettier",
+    ".prettierrc.json": "prettier",
+    ".eslintrc": "eslint",
+    ".eslintrc.json": "eslint",
+    "ruff.toml": "ruff",
+    ".ruff.toml": "ruff",
+    "mypy.ini": "mypy",
+    ".golangci.yml": "golangci-lint",
+    "rustfmt.toml": "rustfmt",
+}
+
+
+@dataclass
+class ProjectContext:
+    root: str
+    languages: list[str] = field(default_factory=list)
+    frameworks: list[str] = field(default_factory=list)
+    paradigms: list[str] = field(default_factory=list)
+    key_files: list[str] = field(default_factory=list)
+    style_hints: list[str] = field(default_factory=list)
+
+    def env_line(self) -> str:
+        langs = ", ".join(self.languages) or "General Software Engineering"
+        if self.frameworks:
+            langs += f" (frameworks: {', '.join(self.frameworks)})"
+        return langs
+
+
+def _walk(root: Path, max_depth: int) -> Iterable[Path]:
+    root = root.resolve()
+    for dirpath, dirnames, filenames in os.walk(root):
+        current = Path(dirpath)
+        try:
+            depth = len(current.relative_to(root).parts)
+        except ValueError:
+            continue
+        dirnames[:] = [d for d in dirnames if d not in IGNORE_DIRS]
+        if depth >= max_depth:
+            dirnames[:] = []
+        for fn in filenames:
+            yield current / fn
+
+
+def detect_languages_and_frameworks(root: Path) -> tuple[list[str], list[str], list[str]]:
+    languages: set[str] = set()
+    frameworks: set[str] = set()
+    key_files: list[str] = []
+
+    for path in _walk(root, MAX_SCAN_DEPTH):
+        name = path.name
+        if name not in LANGUAGE_MARKERS:
+            continue
+        languages.add(LANGUAGE_MARKERS[name])
+        try:
+            key_files.append(str(path.relative_to(root)))
+        except ValueError:
+            key_files.append(str(path))
+
+        try:
+            if name == "package.json":
+                pkg = json.loads(path.read_text(encoding="utf-8"))
+                deps = {**pkg.get("dependencies", {}), **pkg.get("devDependencies", {})}
+                for fw in ("next", "react", "vue", "express", "nestjs", "svelte", "vitest", "jest"):
+                    if any(fw in d for d in deps):
+                        frameworks.add(fw)
+            elif name == "go.mod":
+                txt = path.read_text(encoding="utf-8", errors="ignore")
+                for fw, needle in (("gin", "gin-gonic"), ("gRPC", "grpc"), ("echo", "labstack/echo")):
+                    if needle in txt:
+                        frameworks.add(fw)
+            elif name == "pyproject.toml":
+                txt = path.read_text(encoding="utf-8", errors="ignore").lower()
+                for fw in ("fastapi", "django", "flask", "pydantic", "pytest", "sqlalchemy"):
+                    if fw in txt:
+                        frameworks.add(fw)
+            elif name == "Cargo.toml":
+                txt = path.read_text(encoding="utf-8", errors="ignore")
+                for fw, needle in (("tokio", "tokio"), ("axum", "axum"), ("serde", "serde")):
+                    if needle in txt:
+                        frameworks.add(fw)
+        except (OSError, json.JSONDecodeError):
+            pass
+
+    return sorted(languages), sorted(frameworks), key_files[:20]
+
+
+def detect_paradigms(root: Path) -> list[str]:
+    hints: set[str] = set()
+    read_count = 0
+
+    for path in _walk(root, MAX_SCAN_DEPTH):
+        if read_count >= MAX_FILES_READ:
+            break
+        if path.suffix not in SOURCE_EXTS:
+            continue
+        try:
+            snippet = path.read_text(encoding="utf-8", errors="ignore")[:MAX_BYTES_PER_FILE]
+        except OSError:
+            continue
+        read_count += 1
+
+        if path.suffix == ".py":
+            if "from typing import" in snippet or "typing import" in snippet:
+                hints.add("typed Python")
+            if "async def" in snippet:
+                hints.add("async/await")
+            if "@dataclass" in snippet or "pydantic" in snippet.lower():
+                hints.add("dataclasses/pydantic")
+        elif path.suffix in {".ts", ".tsx"}:
+            if "interface " in snippet or " type " in snippet:
+                hints.add("TypeScript strict types")
+            if "react" in snippet.lower():
+                hints.add("React")
+        elif path.suffix == ".go":
+            if "interface {" in snippet:
+                hints.add("Go interfaces")
+            hints.add("explicit error returns")
+        elif path.suffix == ".rs":
+            if "Result<" in snippet:
+                hints.add("Rust Result-based errors")
+        elif path.suffix == ".js":
+            hints.add("JavaScript")
+
+    return sorted(hints)
+
+
+def detect_style_hints(root: Path) -> list[str]:
+    hints: list[str] = []
+    for marker, label in STYLE_MARKERS.items():
+        if (root / marker).exists() and label not in hints:
+            hints.append(label)
+    return hints
+
+
+def build_project_context(current_working_dir: str) -> ProjectContext:
+    root = Path(current_working_dir)
+    if not root.is_dir():
+        return ProjectContext(root=str(root))
+
+    langs, fws, key_files = detect_languages_and_frameworks(root)
+    return ProjectContext(
+        root=str(root),
+        languages=langs,
+        frameworks=fws,
+        paradigms=detect_paradigms(root),
+        key_files=key_files,
+        style_hints=detect_style_hints(root),
+    )

contextlayer_mcp_server-0.1.0/contextlayer/server.py

@@ -0,0 +1,26 @@
+"""MCP server entry point. Run with: python -m contextlayer.server"""
+from __future__ import annotations
+
+from mcp.server.mcpserver import MCPServer
+
+from contextlayer.detection import build_project_context
+from contextlayer.wrapper import build_expert_prompt
+
+mcp = MCPServer("ContextLayer-SE")
+
+
+@mcp.tool()
+def analyze_and_wrap_prompt(user_prompt: str, current_working_dir: str) -> str:
+    """Detect the project's tech stack, then wrap `user_prompt` in a
+    strict senior-engineer schema before the model ever sees it."""
+    ctx = build_project_context(current_working_dir)
+    return build_expert_prompt(user_prompt, ctx)
+
+
+def main() -> None:
+    import anyio
+    anyio.run(mcp.run_stdio_async)
+
+
+if __name__ == "__main__":
+    main()

contextlayer_mcp_server-0.1.0/contextlayer/wrapper.py

@@ -0,0 +1,32 @@
+"""Prompt wrapper: turns a ProjectContext + user prompt into an expert prompt."""
+from __future__ import annotations
+
+from .detection import ProjectContext
+
+SE_DIRECTIVES = """\
+CRITICAL OUTPUT DIRECTIVES:
+1. Do NOT explain basic concepts. Provide direct, production-grade solutions immediately.
+2. Enforce strict type safety and error handling matching best practices for the detected stack.
+3. Output code snippets first, followed only by highly specific edge cases or impacted file names.
+4. Match existing codebase paradigms layout in the working directory.
+5. Do not introduce new frameworks or dependencies unless explicitly requested."""
+
+
+def build_expert_prompt(user_prompt: str, ctx: ProjectContext) -> str:
+    paradigms = ", ".join(ctx.paradigms) or "none detected"
+    style = ", ".join(ctx.style_hints) or "none detected"
+    manifests = "\n    - ".join(ctx.key_files) or "(no manifest files found)"
+
+    return f"""ROLE: Principal Systems Architect & Senior Engineer.
+ENVIRONMENT DETECTED: {ctx.env_line()}
+
+DETECTED PARADIGMS: {paradigms}
+DETECTED STYLE CONFIG: {style}
+KEY MANIFESTS:
+    - {manifests}
+
+{SE_DIRECTIVES}
+
+USER REQUEST:
+{user_prompt}
+"""

contextlayer_mcp_server-0.1.0/contextlayer_mcp_server.egg-info/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: contextlayer-mcp-server
+Version: 0.1.0
+Summary: Invisible intelligence layer for AI coding tools (MCP)
+Author: Rudra Nalawade
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.0.0

contextlayer_mcp_server-0.1.0/contextlayer_mcp_server.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+pyproject.toml
+contextlayer/__init__.py
+contextlayer/detection.py
+contextlayer/server.py
+contextlayer/wrapper.py
+contextlayer_mcp_server.egg-info/PKG-INFO
+contextlayer_mcp_server.egg-info/SOURCES.txt
+contextlayer_mcp_server.egg-info/dependency_links.txt
+contextlayer_mcp_server.egg-info/entry_points.txt
+contextlayer_mcp_server.egg-info/requires.txt
+contextlayer_mcp_server.egg-info/top_level.txt
+tests/test_detection.py

contextlayer_mcp_server-0.1.0/contextlayer_mcp_server.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

contextlayer_mcp_server-0.1.0/contextlayer_mcp_server.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+contextlayer = contextlayer.server:main

contextlayer_mcp_server-0.1.0/contextlayer_mcp_server.egg-info/requires.txt

@@ -0,0 +1 @@
+mcp>=1.0.0

contextlayer_mcp_server-0.1.0/contextlayer_mcp_server.egg-info/top_level.txt

@@ -0,0 +1 @@
+contextlayer

contextlayer_mcp_server-0.1.0/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "contextlayer-mcp-server"  # <--- CHANGED THIS
+version = "0.1.0"
+description = "Invisible intelligence layer for AI coding tools (MCP)"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    { name = "Rudra Nalawade" }
+]
+dependencies = ["mcp>=1.0.0"]
+
+[project.scripts]
+contextlayer = "contextlayer.server:main" # <--- Keep this as "contextlayer"

contextlayer_mcp_server-0.1.0/setup.cfg

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

contextlayer_mcp_server-0.1.0/tests/test_detection.py

@@ -0,0 +1,47 @@
+from pathlib import Path
+
+from contextlayer.detection import (
+    build_project_context,
+    detect_languages_and_frameworks,
+    detect_paradigms,
+    detect_style_hints,
+)
+
+
+def test_node_project(tmp_path: Path):
+    (tmp_path / "package.json").write_text(
+        '{"dependencies": {"react": "^18.0.0", "next": "^14.0.0"}}'
+    )
+    (tmp_path / "index.tsx").write_text(
+        "interface User { id: string }\nimport React from 'react'\n"
+    )
+    ctx = build_project_context(str(tmp_path))
+    assert "Node.js" in ctx.languages
+    assert "react" in ctx.frameworks
+    assert "next" in ctx.frameworks
+    assert "TypeScript strict types" in ctx.paradigms
+
+
+def test_python_project_ignores_venv(tmp_path: Path):
+    (tmp_path / "pyproject.toml").write_text("[project]\nname='x'\ndependencies=['fastapi']\n")
+    (tmp_path / "app.py").write_text("from typing import Optional\nasync def f(): pass\n")
+    venv = tmp_path / "venv" / "lib"
+    venv.mkdir(parents=True)
+    (venv / "bad.py").write_text("this should never be read")
+    ctx = build_project_context(str(tmp_path))
+    assert "Python" in ctx.languages
+    assert "fastapi" in ctx.frameworks
+    assert "async/await" in ctx.paradigms
+
+
+def test_nonexistent_dir_is_safe():
+    ctx = build_project_context("/definitely/does/not/exist")
+    assert ctx.languages == []
+
+
+def test_style_hints(tmp_path: Path):
+    (tmp_path / ".prettierrc").write_text("{}")
+    (tmp_path / "ruff.toml").write_text("")
+    hints = detect_style_hints(tmp_path)
+    assert "prettier" in hints
+    assert "ruff" in hints