mcp-cs

v2.2.0

Published

a month ago

MCS (mcp-cs) — IEEE Computer Society Universal Campus Developer, Diagnostics & AlgoJudge Competitive Execution MCP Server

Downloads

1,000

⚡ 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

⚡ 3. Web Performance Suite

🩺 4. Environment & System Doctor

🛡️ 5. Security & Secrets Guard

🌐 6. API Client & Mock Generator

📚 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)

🎨 3. Frontend & UI Engineering (2 Skills)

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

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

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