Project Scope

Name: Project Scope
Author: adityasasidhar

@adityasasidhar

About Project Scope

A production-ready MCP server that gives AI agents deep codebase understanding. Features AST-based semantic analysis, context-aware security scanning (zero false positives on source code), safe refactoring tools with previews, and comprehensive Git operations.

#devtools #mcp-server #security #refactoring #git #ast #nodejs #typescript #agent-tools

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "project-scope": {
      "command": "npx",
      "args": [
        "-y",
        "@adityasasidhar/project-scope-mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Project Scope?

Project Scope is a production-grade MCP server for semantic code intelligence and safe repository control. It gives AI agents deep, structural understanding of codebases and the ability to modify them safely through AST analysis, context-aware security scanning, refactoring tools, and Git operations.

How to use Project Scope?

To use Project Scope, configure your AI agent’s MCP client to connect to this server. You can then invoke its tools, such as get_repo_structure for repository analysis, scan_repo_for_threats for security scanning, refactor_rename for refactoring, and git_status for Git operations.

Key features of Project Scope

Semantic repository analysis using Tree-sitter AST parsing
Context-aware security scanning with zero false positives
Safe refactoring tools with mandatory preview before apply
Git-native operations for status, history, and comparison
Defense-in-depth security with prompt injection detection
Fully local execution with no external dependencies

Use cases of Project Scope

Large codebase understanding for AI agents
Safe autonomous refactoring with syntax guarantees
Secure agent-driven code changes with context scanning
Repository audits and change impact analysis
AI-assisted code reviews with semantic understanding

FAQ from Project Scope

What distinguishes Project Scope from naive pattern-based scanners?

Project Scope uses context-sensitive scanning that parses source code rather than pattern-matching, eliminating false positives on legitimate code.

Does Project Scope run locally?

Yes, Project Scope is fully local execution, built with TypeScript, Node.js, and Tree-sitter.

What security measures does Project Scope include?

It includes prompt injection detection, regex and heuristic guards, optional integration with Meta Llama Prompt Guard 2, and file access and execution boundaries.