mcp-cs

⚡ MCS (mcp-cs)

The Universal Campus Developer, Diagnostics & AlgoJudge Competitive Execution Suite

MCS (Model Context Server for Computer Society) is a full-featured Model Context Protocol (MCP) server, standalone developer CLI, and visual console created for developers, university students, competitive programmers, and engineering teams.

Installation • Terminal CLI • Visual Console • Client Configuration • Tool Catalog

🌟 Why MCS?

MCS connects your AI assistant (Antigravity, Cursor, Claude Desktop, Windsurf, Cline) directly to powerful local execution, repository diagnostics, database modeling, and competitive algorithm tools with zero manual configuration.

• ⚡ AlgoJudge Engine: Run sandboxed code (Python, JS/TS, C++, Go, Docker micro-containers), perform automated differential stress-testing, and check AST code similarity.
• 🩺 Environment Doctor: Diagnose project setups, detect .env disparities, and inspect port conflicts with process PIDs.
• 🗄️ Database & ERD: Parse SQL schemas and auto-generate Mermaid Entity-Relationship diagrams.
• ⚡ Web Performance: Scan for oversized raster assets and audit HTTP compression & security headers.
• 🛡️ Security Guard: Detect leaked API keys, tokens, and hardcoded credentials before committing.
• 🌐 API Playground: Live HTTP test client and realistic synthetic mock data generator.

💻 Standalone Terminal CLI Commands

In addition to serving AI assistants, MCS works as a standalone terminal productivity CLI:

# 1. Run instant project diagnostics & .env synchronization check
mcs doctor

# 2. Inspect active network ports and process PIDs
mcs ports

# 3. Scan repository for leaked secrets and API keys
mcs scan

# 4. Generate Mermaid ER diagram from a SQL file
mcs erd schema.sql

# 5. Launch the embedded visual web dashboard
mcs ui

# 6. Launch the official Model Context Protocol Inspector
mcs inspector

🖥️ Interactive Visual Dashboard

Launch the embedded graphical visualizer locally with either command:

mcs ui
# or
npx mcp-cs --ui

📦 Installation Guide

Method 1: Instant Run via npx (Recommended — No install needed)

{
  "mcpServers": {
    "mcs": {
      "command": "npx",
      "args": ["-y", "mcp-cs"]
    }
  }
}

Method 2: Homebrew Installation (macOS & Linux)

brew tap ieeecsopen/tap
brew install mcs

Method 3: Global NPM Installation

npm install -g mcp-cs

🎛️ Modular Tool Filtering

To save prompt tokens in your AI assistants, enable only the specific tool modules you need:

# Enable only algorithm and doctor tools
MCS_MODULES=algo,doctor npx mcp-cs

# Or via CLI arguments
mcp-cs --modules=algo,security,db

Supported module tags: algo, doctor, security, db, perf, api, docs, code, git, problem, ci, wasm.

🔌 Client Configuration

1. Antigravity IDE

Add mcs to your global configuration file at ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "mcs": {
      "command": "npx",
      "args": ["-y", "mcp-cs"]
    }
  }
}

2. Claude Desktop

Add to your Claude configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "mcs": {
      "command": "npx",
      "args": ["-y", "mcp-cs"]
    }
  }
}

3. Cursor IDE

• Open Settings (Cmd + , on Mac or Ctrl + , on Windows).
• Go to Features $\to$ MCP.
• Click + Add New MCP Server:
  • Name: mcs
  • Type: command
  • Command: npx -y mcp-cs

🛠️ Complete Tool Catalog (25 Tools)

⚡ 1. AlgoJudge Competitive & Algorithm Engine

Tool	Description	Example Prompt
algo_run_sandboxed	Runs code in Python, JS, TS, C++, C, or Go in an isolated process with strict time and memory limits.	"Run this C++ solution with the test input 5\n1 2 3 4 5."
algo_run_docker	Runs code inside a zero-trust ephemeral Docker micro-container (python:alpine, node:alpine, gcc:alpine).	"Run this untrusted script inside a Docker sandbox."
algo_stress_test	Automated Differential Tester: Compares an optimal algorithm against a brute-force baseline on randomized inputs to find failing edge cases.	"Stress-test my Dijkstra implementation against a brute-force solution to find where it fails."
algo_check_plagiarism	Token-based AST code similarity checker that compares two code submissions and detects suspicious duplicated logic.	"Check if solution_a.py and solution_b.py have plagiarized logic."
algo_generate_edge_cases	Generates adversarial corner cases (min $N=1$, max constraints, identical items, extreme negatives, disconnected graphs).	"Generate edge testcases for a binary tree problem."

🗄️ 2. Database & Schema Suite

Tool	Description	Example Prompt
db_generate_erd	Parses SQL CREATE TABLE and foreign key statements to automatically generate Mermaid Entity-Relationship Diagrams.	"Generate a Mermaid ERD diagram from this schema.sql file."

⚡ 3. Web Performance Suite

Tool	Description	Example Prompt
perf_audit_assets	Scans directory for uncompressed raster images (>250KB) and calculates bandwidth savings from WebP/AVIF conversion.	"Audit the images in /public and show me how much size we can save with WebP."
perf_check_headers	Audits HTTP response headers of a web application for Gzip/Brotli compression, Cache-Control, and security headers.	"Check the performance and security headers on http://localhost:3000."

🩺 4. Environment & System Doctor

Tool	Description	Example Prompt
doctor_diagnose_project	Auto-detects runtime (Node, Next.js, Python, Docker), missing node_modules, missing .env, and unconfigured virtual environments.	"Diagnose why this repo won't start."
doctor_check_env	Diffs .env against .env.example to detect missing or surplus keys.	"Check if my .env is missing any keys from .env.example."
doctor_port_inspect	Identifies which background processes and PIDs are locking ports (3000, 6379, 5432).	"Check why port 6379 is occupied."

🛡️ 5. Security & Secrets Guard

Tool	Description	Example Prompt
security_scan_secrets	Scans codebase for leaked OpenAI keys, AWS access tokens, GitHub PATs, and private keys.	"Scan my repository for accidentally committed secrets."
security_auto_sanitize	Auto-replaces detected secrets with process.env references and populates .env.example.	"Sanitize all hardcoded keys across the project."

🌐 6. API Client & Mock Generator

Tool	Description	Example Prompt
api_test_request	Executes live HTTP calls (GET, POST, PUT, DELETE) with headers, auth, and query params — measures latency (TTFB) and formats JSON.	"Send a GET request to https://api.github.com/zen and show the latency."
api_generate_mock_data	Generates realistic synthetic mock datasets (users, products, posts, transactions) for frontend and backend testing.	"Generate 10 mock user records with IDs and emails."

📚 7. Documentation & Code Hygiene

Tool	Description	Example Prompt
docs_check_broken_links	Scans all markdown files (.md, .mdx) to detect broken internal links and dead file references.	"Check all markdown files in the repo for broken links."
docs_auto_fix_links	Automatically updates and rewrites broken markdown links when target files have moved.	"Fix broken links in the docs/ folder."
docs_extract_code_snippets	Extracts all fenced code blocks from markdown documentation for quick inspection.	"Extract all code snippets in docs/ so we can verify their syntax."
code_find_todos	Scans the codebase for TODO, FIXME, HACK, and BUG comments with line numbers and file paths.	"Find all TODO and FIXME comments in the codebase."
code_inspect_heavy_dependencies	Inspects package.json to identify bloated dependencies (moment, lodash, monaco, katex) with optimization tips.	"Check if we have heavy dependencies slowing down our bundle."

🚀 8. Git, Release & CI/CD Suite

Tool	Description	Example Prompt
git_generate_changelog	Parses conventional git commit history between tags and outputs a clean markdown changelog.	"Generate a changelog for all commits since v1.0.0."
git_pr_readiness_check	Verifies uncommitted files, unpushed commits, and branch health before opening a Pull Request.	"Check if my branch is ready for a Pull Request."
git_generate_pr_description	Generates a structured markdown Pull Request description summarizing branch commits and diffs.	"Generate a structured PR description for my current branch."
problem_fetch_codeforces	Fetches problem statements, sample inputs/outputs, tags, and contest limits from Codeforces.	"Fetch the details for Codeforces problem 2060A."
ci_generate_workflow	Generates production-ready GitHub Actions CI/CD workflows for Next.js, NPM Publishing, Docker, or Python.	"Generate a GitHub Action workflow to automatically publish this package to NPM."

🧠 Agent Skills Suite (30 Skills • Compatible with skills.sh)

MCS bundles 30 production agent skills adhering to the open skills.sh standard. These provide AI assistants (Antigravity, Cursor, Claude Code, Windsurf) with specialized operational runbooks:

# 1-Click Install all 30 skills into any project (.agents/skills/)
mcs skills install

# Or install for Cursor (.cursor/rules/)
mcs skills install --cursor

# Or install via skills.sh open package manager
npx skills add ieeecsopen/mcp-cs

🎓 1. Campus & Student Engineering (8 Skills)

Skill Name	What It Instructs the AI Agent to Do
campus-fyp-architecture	Plans and documents university Final Year Projects (FYP) with C4 architecture diagrams, tech comparisons, and IEEE Std 830 SRS chapters.
campus-ieee-citation	Formats online software, journals, DOIs, and papers into strict IEEE referencing format.
campus-lab-report-generator	Auto-generates structured IEEE 2-column practical lab reports and experiment write-ups.
campus-git-team-workflow	Guides student group projects on feature branching, rebase strategies, and conventional commits.
campus-presentation-script	Generates 10-minute slide outlines and word-for-word viva defense speaking scripts.
campus-assignment-cleaner	Pre-flight LMS assignment validator (strips node_modules/.DS_Store, checks student ID headers).
campus-hackathon-fast-scaffold	10-minute rapid prototyping architecture for 12h/24h hackathons (SLIITXtreme).
campus-dsa-visualizer	Generates step-by-step ASCII memory traces for LinkedLists, BST trees, DP tables, and Graphs.

⚡ 2. Competitive Programming & Algorithms (4 Skills)

Skill Name	Description
algo-stress-testing	Differential testing against brute-force baselines to find edge-case failures.
algo-edge-case-generator	Generates corner cases ($N=1$, bounds, extremes, disconnected graphs).
algo-plagiarism-detector	AST token similarity analysis between code submissions.
algo-complexity-analyzer	Asymptotic Big-O time and space complexity auditing.

🎨 3. Frontend & UI Engineering (2 Skills)

Skill Name	Description
frontend-clean-ui	Modern, high-contrast, accessible SaaS UI design with Tailwind and dark mode tokens.
react-state-architecture	State architecture using Zustand, TanStack Query, and React Server Components.

🗄️ 4. Backend, Databases & APIs (4 Skills)

Skill Name	Description
backend-rest-api-design	Production REST API design with Zod schemas, status codes, and cursor pagination.
database-migration-guardian	Zero-downtime database schema migrations, indexes, and safe alterations.
db-architect	Parses SQL DDL statements into visual Mermaid ER diagrams.
api-mock-generator	Generates realistic synthetic datasets (users, products, transactions).

🤖 5. AI, Testing & DevOps (12 Skills)

Skill Name	Description
ai-rag-pipeline-architect	Retrieval-Augmented Generation (RAG) pipelines with vector embeddings and reranking.
ai-prompt-evaluator	System prompt engineering, red-teaming, and structured JSON output validation.
test-unit-generator	Vitest / Jest unit test suites with parameterized edge cases and 100% coverage.
test-e2e-playwright	Resilient Playwright browser test specs with user-facing accessibility locators.
devops-dockerfile-optimizer	Secure multi-stage Dockerfiles with layer caching and non-root users.
devops-vercel-render-deploy	Cloud hosting configuration for Vercel, Supabase, and Render.
repo-doctor	Identifies broken runtime dependencies, missing packages, and setup errors.
env-sync	Compares and synchronizes .env against .env.example.
port-inspector	Resolves socket collisions (EADDRINUSE) and identifies holding PIDs.
ci-workflow-architect	Generates GitHub Actions CI/CD workflows for Node, Docker, and Python.
security-auditor	Pre-flight scanner to detect and auto-sanitize leaked API credentials.
docs-broken-link-checker	Scans markdown files for broken internal links and dead references.

🧩 Interactive Prompts & Resources

Slash Commands / Prompts:

• /diagnose-repo: Runs full system doctor diagnostics, checks environment variables, scans ports, and generates an onboarding report.
• /stress-test-solution: Interactive algorithm stress-testing assistant to find counter-example edge cases.
• /prepare-pr: Pre-flight PR creation checklist and summary.

Dynamic Context Resources:

• resource://system/ports: Live socket feed of active network ports.
• resource://git/status: Real-time repository branch and sync state.

💻 Local Development

# 1. Clone repository
git clone https://github.com/ieeecsopen/mcp-cs.git
cd mcp-cs

# 2. Install dependencies
npm install

# 3. Run automated tests (23 tests)
npm test

# 4. Build TypeScript
npm run build

# 5. Start in development mode with UI
npm run dev -- --ui

📄 License & Community

Distributed under the MIT License.

Maintained with ❤️ by the IEEE Computer Society of SLIIT.