Node.js MCP Server

A specialized MCP server focused on 3 Core Jobs for agentic workflows.

The 3 Jobs

1. Context Management & Learning

The agent can manage the project's documentation and "learn" the entire context.

• Tool: md
• Actions:
  • read_all: Reads README.md from the specified path.
  • update_all: Overwrites/updates README.md with new content provided by the client.
  • Arguments:
    • path (string, optional) - Absolute path to project root.
    • content (string, required for update_all) - The new content for README.md.

2. Test Management

The agent can manage the project's tests in a unified workflow.

• Tool: test
• Action: test
• Functionality:
  1. Writes the provided test code to test_path.
  2. Runs the project's test suite (npm test).
  3. Reports output and errors to test.md.
• Arguments:
  • path (string, optional) - Absolute path to project root.
  • test_path (string, required) - Relative path to the test file (e.g., tests/api.test.js).
  • code (string, required) - Content of the test file.

3. Build & Run

• Tool: deploy
• Actions:
  • dev: Runs the project in development mode.
  • prod: Builds the project and runs it.
  • Arguments:
    • path (string, optional) - Absolute path to project root.

Installation & Usage

1. Build the Server

cd /home/mc/Desktop/mcpserver
npm install
npm run build

2. Configuration (Claude / Antigravity)

Add to your MCP configuration file:

Location: ~/.config/Claude/claude_desktop_config.json (Linux)

{
  "mcpServers": {
    "job-server": {
      "command": "node",
      "args": ["/home/mc/Desktop/mcpserver/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "my-job-server": {
      "command": "node",
      "args": ["/home/mc/Desktop/mcpserver/dist/index.js"]
    }
  }
}

3. Usage Examples

Manage Tests

To create a test, update it, or simply run existing tests (by re-submitting the code), use the test tool.

{
  "name": "test",
  "arguments": {
    "action": "test",
    "path": "/home/mc/Desktop/ServiceApp",
    "test_path": "tests/login.test.js",
    "code": "describe('Login', () => { ... });"
  }
}

The server will:

1. Save tests/login.test.js.
2. Run npm test.
3. Report full results to test.md.

Troubleshooting

• Path Issues: Always provide the path argument.
• npm test: The test action requires a valid test script in the project's package.json.