mcp-cs

⚡ MCP-CS (mcp-cs)

The Universal Developer Operations, Diagnostics & AlgoJudge Competitive Execution Suite

A full-featured Model Context Protocol (MCP) server created for developers, competitive programmers, and engineering teams.

Installation • Tool Catalog • Prompts & Resources • Contributing

🌟 Why mcp-cs?

mcp-cs 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), 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.

📦 Installation & Setup

You do not need to clone the repository to use mcp-cs. It runs automatically via npx.

1. Antigravity Configuration

Add mcp-cs to your global MCP configuration file at ~/.gemini/config/mcp_config.json:

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

2. Claude Desktop

Add to your Claude configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

3. Cursor IDE

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

4. Windsurf & Cline / Roo-Code

Add the following under mcpServers in your settings:

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

🛠️ Complete Tool Catalog (24 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_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."

🌐 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_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."

🧩 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

To contribute or run mcp-cs from source:

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

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

# 4. Start in development mode
npm run dev

📄 License & Community

Distributed under the MIT License.

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