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.

InstallationTerminal CLIVisual ConsoleClient ConfigurationTool 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.

A
license - permissive license
B
quality
A
maintenance

Maintenance

Maintainers
Response time
0dRelease cycle
3Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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.
  • 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
    Not graded
    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.
    MIT

View all related MCP servers

Related MCP Connectors

  • Generate SBOMs, scan vulnerabilities, and analyze dependencies from local projects or Git repos.

  • Deterministic context layer for your codebase: change impact, blast radius, answers with receipts.

  • JSON/YAML, regex, diff, JWT, SQL dialects — the keyless millisecond ops an agent needs mid-task.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ieeecsopen/mcp-cs'

If you have feedback or need assistance with the MCP directory API, please join our Discord server