Project Knowledge MCP server

Project Knowledge MCP Server

A cross-project knowledge graph for the Model Context Protocol (MCP). Map features across mobile, backend, and admin codebases so your AI agent has full-stack context when testing, writing code, debugging, or adding features.

Quick Start

npx -y project-knowledge-mcp --knowledge-file ./project-knowledge.json

Then add to your MCP settings:

{
  "mcpServers": {
    "project-knowledge": {
      "command": "npx",
      "args": [
        "-y",
        "project-knowledge-mcp",
        "--knowledge-file", "C:\\projects\\project-knowledge.json"
      ],
      "autoApprove": []
    }
  }
}

Table of Contents

• Overview
• Features
• Prerequisites
• Installation & Configuration
• Knowledge File Management
• Tools Reference
• Usage Walkthrough
• Security
• Contributing
• License

Overview

The Problem

When working on a project with multiple codebases — for example, a React Native mobile app, a NestJS backend, and a Next.js admin panel — the AI agent has no awareness of how a single feature flows across all three. This leads to incomplete context, missed dependencies, and breaking changes that could have been caught earlier.

The Solution

This MCP server stores a knowledge graph of your features, mapping each workflow step to the relevant screens, endpoints, controllers, and files in every project. The AI agent can then query this graph to understand end-to-end feature flows, detect cross-project impacts before editing files, and keep type definitions synchronized across codebases.

Features

• Multi-project awareness — register any number of projects (mobile, backend, admin, etc.)
• Feature workflow mapping — define features as ordered steps across all projects
• Auto-scanning — discover NestJS endpoints, Next.js pages, and React Native screens automatically
• Full-text search — search across features, endpoints, files, and screens
• Cross-reference lookup — given a file path, find which features reference it
• Rich context — retrieve all endpoints, screens, and files for a feature at a specific workflow step
• Breaking change detection — before editing a file, see which other projects will be affected
• Type/schema synchronization — map equivalent types across projects (e.g., ProductCreateDto ↔ ProductFormSchema)
• Architecture exploration — browse any project's directory tree with keyword filtering and content highlighting
• Health validation — verify that all registered file paths still exist; auto-detect stale entries
• Persistent knowledge — auto-saves to a JSON file after every mutation; can be git-tracked and shared
• 100% dynamic — all configuration via CLI arguments and runtime tools; no source code edits required

Prerequisites

• Node.js >= 18
• npm >= 9 (or pnpm / yarn equivalent)
• An MCP-compatible client (e.g., VS Code with Cline, any AI-powered IDE)

Installation & Configuration

Install from npm (recommended)

npm install --save-dev project-knowledge-mcp

Or run directly without installing:

npx -y project-knowledge-mcp --knowledge-file ./project-knowledge.json

Build from Source

git clone https://github.com/punic-pillars/project-knowledge-mcp.git
cd project-knowledge-mcp
npm install
npm run build

CLI Flags

All configuration is provided via CLI arguments. No environment variables or configuration files are required.

Shortened. The full README is on GitHub.