Skip to main content
Glama

⚡ MCS (mcp-cs)

The Universal Campus Developer, Diagnostics & AlgoJudge Competitive Execution Suite

npm version License: MIT Node.js MCP Organization

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.


Related MCP server: FastApply MCP Server

💻 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

  1. Open Settings (Cmd + , on Mac or Ctrl + , on Windows).

  2. Go to Features $\to$ MCP.

  3. 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.

Available Tools

28 tools
algo_check_plagiarismA

Compares two code submissions using token-level AST analysis and returns similarity percentage and verdict

Inputs: codeA (required), codeB (required).

algo_generate_edge_casesB

Generates adversarial corner cases (min N=1, max bounds, identical items, extreme negatives, disconnected graphs)

Inputs: maxN, type.

algo_run_dockerA

Executes code inside a zero-trust ephemeral Docker container (python:alpine, node:alpine, gcc:alpine) with no network access

Inputs: code (required), stdin, language, timeoutMs.

algo_run_sandboxedB

Executes code in an isolated process with strict timeout and memory limits (supports python, javascript, typescript, cpp, c, go)

Inputs: code (required), stdin, language, timeoutMs.

algo_stress_testA

Automated differential tester: runs a fast solution against a brute-force baseline using randomized inputs until a failing edge case is found

Inputs: solutionCode (required), generatorCode (required), bruteForceCode (required), language, +1 more.

api_generate_mock_dataC

Generates realistic synthetic mock data (users, products, posts, transactions) for testing

Inputs: type, count.

api_test_requestC

Executes an HTTP request (GET, POST, PUT, DELETE, PATCH) and measures latency & formats response data

Inputs: url (required), body, method, headers, +1 more.

ci_generate_workflowB

Generates production-ready GitHub Actions CI/CD workflows for Next.js, NPM Publishing, Docker, or Python

Inputs: type (required).

code_find_todosA

Scans the codebase for TODO, FIXME, HACK, and BUG comments with line numbers and file paths

Inputs: targetDir.

code_inspect_heavy_dependenciesA

Inspects package.json to identify bloated dependencies (moment, lodash, monaco, katex) with optimization tips

Inputs: projectPath.

db_generate_erdA

Parses SQL table definitions and generates a clean Mermaid Entity-Relationship (ER) Diagram

Inputs: schemaSql (required).

docs_extract_code_snippetsB

Extracts all fenced code blocks from markdown documentation for quick inspection and review

Inputs: targetDir.

doctor_check_envA

Compares .env against .env.example and flags missing or extra environment keys

Inputs: projectPath.

doctor_diagnose_projectA

Scans project structure, detects language/framework, missing dependencies, and setup issues

Inputs: projectPath.

doctor_port_inspectA

Checks if specific network ports (e.g. 3000, 6379, 5432) are occupied and by which process PID

Inputs: ports (required).

git_generate_changelogA

Parses conventional git commit history between tags and outputs a clean markdown changelog

Inputs: toTag, fromTag.

git_generate_pr_descriptionA

Generates a structured markdown Pull Request description summarizing branch commits and diffs

Inputs: targetBranch.

git_pr_readiness_checkA

Verifies uncommitted files, unpushed commits, and branch health before opening a Pull Request

Inputs: no named parameters.

perf_audit_assetsA

Scans repository for oversized raster images (>250KB) and calculates bandwidth savings from WebP/AVIF conversion

Inputs: targetDir, thresholdKb.

perf_check_headersA

Audits HTTP response headers of a web application for Gzip/Brotli compression, Cache-Control, and security headers

Inputs: url (required).

problem_fetch_codeforcesA

Fetches problem statement metadata, tags, and contest limits from Codeforces

Inputs: index (required), contestId (required).

security_auto_sanitizeA

Auto-replaces detected hardcoded secrets with process.env references and populates .env.example

Inputs: dryRun, targetDir.

security_scan_secretsA

Scans repository text files for accidentally hardcoded API keys, JWTs, and private tokens

Inputs: targetDir.

skills_installA

Installs official MCS agent skills (algo-stress-testing, repo-doctor, db-architect, security-auditor) into local repository (.agents/skills/ or .cursor/rules/)

Inputs: format, targetDir.

wasm_run_moduleC

Executes pre-compiled WebAssembly (.wasm) binary in memory with exported function calls

Inputs: wasmBase64 (required), functionName (required), args.

wasm_run_vm_sandboxA

Executes JavaScript in an isolated Node.js VM context with strict execution timeout and zero filesystem access

Inputs: code (required), timeoutMs.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 28 tools

    Disambiguation4/5

    Category prefixes like security_, algo_, and docs_ mostly keep tools organized, and most pairings (scan/sanitize, check/fix) have distinct roles. A couple of execution tools are easy to confuse, especially `wasm_run_vm_sandbox` (which runs JavaScript, not WebAssembly) alongside `wasm_run_module`, and `algo_run_sandboxed` vs `algo_run_docker` require a close read.

    Naming Consistency4/5

    The overwhelming majority follows a `category_verb_noun` snake_case pattern, e.g. security_scan_secrets, ci_generate_workflow, docs_check_broken_links. Minor deviations like `git_pr_readiness_check`, `doctor_port_inspect`, and `security_auto_sanitize` break the pattern slightly but don't make the set unpredictable.

    Tool Count2/5

    With 28 tools spanning security, algo, wasm, db, perf, doctor, api, docs, code, git, problem, skills, and ci, this exceeds a reasonable single-server scope and feels like several focused servers merged. Category prefixes mitigate the chaos, but the count is too high for a coherent tool collection.

    Completeness3/5

    The server has useful workflows in a few areas, such as secret scan→sanitize, docs check→fix links, and algorithm stress testing, but many domains are represented by only one-off tools (db_generate_erd, problem_fetch_codeforces, skills_install). There are notable lifecycle gaps: git stops at PR description instead of PR creation/merging, and CI generates a workflow but does not validate or update it.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides unified development tools including code analysis, debugging, refactoring, documentation, testing, and project automation through multiple LLM providers (KIMI, GLM, OpenRouter). Features agentic audit capabilities with multi-model consensus for finding issues and generating direct fixes.
      Apache 2.0
    • F
      license
      C
      quality
      D
      maintenance
      Enterprise-grade code intelligence platform providing AI-powered code analysis, semantic search, security scanning, and automated refactoring capabilities. Integrates with local AI models for zero-cost operations while delivering comprehensive development workflow automation.
      2
      8
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI-powered development tools including code generation, refactoring, debugging, performance optimization, and test generation, along with smart prompts for code analysis and documentation, and a built-in knowledge base of coding best practices.
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Provides intelligent error detection and debugging capabilities across multiple programming languages with real-time monitoring of build, lint, runtime, console, and test errors. Offers AI-enhanced error analysis with automated resolution suggestions and context-aware debugging.
      2
      MIT