Tymek/js-mcp

JS Development MCP Server

A Model Context Protocol (MCP) server for better JS/TS development. It enables

• accurate scripts use
• project tooling discovery
• improved background tasks

Better context leads to less friction and struggle with project tooling.

Warning: Using this has a YOLO vibe coding factor of arbitrary 8/10 – No warranty if this breaks your project, computer, or your life, but it probably won't. Don't leave your agents unsupervised. This server allows you to run npm scripts in VSCode copilot without manual terminal command approval every time, so be careful.

Quick Start

npx js-mcp

For VSCode / Claude Desktop:

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

Instructions for LLM Agents & AI Assistants

🤖 Agent Instructions for JS/TS Projects

In Javascript or Typescript projects, PREFER TO USE TOOLS INSTEAD OF TERMINAL COMMANDS:

• npm test → run-tests (framework detection, better errors)
• npm run build → build-project (optimization detection)
• npm install → install-deps (auto-detects npm/yarn/pnpm)
• npm run <script> → run-script (background detection, args support)
• Checking package.json → list-scripts or project-status

Benefits: No terminal approval prompts, enhanced error context, framework awareness, proper background task management.

Workflow: Start with get-help for guidance, use project-status for unknown projects, then use specific tools.

Tools

1. get-help - Get intelligent recommendations for which tools to use
2. run-tests - Run project tests with framework detection and better errors
3. build-project - Build projects with optimization detection and framework awareness
4. install-deps - Install dependencies with auto-detected package manager (npm/yarn/pnpm)
5. run-script - Run npm scripts with background detection and argument support
6. list-scripts - List and categorize all available npm scripts
7. project-status - Check comprehensive project health and framework detection

Key Features

• Framework Detection: Next.js, React, Vue.js, Express, NestJS, and more
• Background Task Management: Auto-detection for dev servers, manual control, output capture
• Smart Error Handling: Contextual suggestions and dependency checking
• Package Manager Detection: Auto-detects npm, yarn, or pnpm from lock files
• Custom Timeout Support: Configure timeouts (1s-5m) for long-running commands, with smart defaults

Background Task Auto-Detection

Always Background: Scripts containing dev, start, serve, watch
Never Background: Scripts starting with cleanup, clean, reset, install, build, compile, bundle, lint, format, test, deploy, publish, release, prepare, verify, check, validate, audit, update, upgrade, migration, migrate, seed, init, setup, config

Development

Local development:

git clone <repo>
npm install
npm run build
npm start

License

GPL-3.0 License

Contributing

Go ahead. Feel free to extend this project with additional tools as needed. I can't promise to review or merge PRs. This codebase is a gift, not a commitment.