dev-workflow-mcp

An MCP server that gives Claude Code extra tools for everyday development work: reading files, exploring project structure, searching code, checking git state, and generating review checklists.

Install

cd "/Users/asimali/development/mcp servers/dev-workflow-mcp"
npm install

Related MCP server: Claude Code MCP

Add to Claude Code

Option A: CLI (recommended)

claude mcp add dev-workflow -- node "/Users/asimali/development/mcp servers/dev-workflow-mcp/server.js"

Option B: Manual config

Add this to your Claude Code MCP config (e.g. .claude.json or the relevant mcpServers block):

{
  "mcpServers": {
    "dev-workflow": {
      "command": "node",
      "args": ["/Users/asimali/development/mcp servers/dev-workflow-mcp/server.js"]
    }
  }
}

The server uses process.cwd() as the project root for all file/search operations, so it reflects whatever directory Claude Code launches it from.

Tools

All tools fail gracefully — errors (missing files, invalid paths, non-git directories, etc.) are returned as readable error messages instead of crashing the server.

Usage Examples

Ask Claude Code to use these tools naturally:

• "Read package.json" → read_project_file

• "Show me the project structure" → list_project_structure

• "Find all imports of React" → search_code

• "What's the current git status?" → git_info

• "Give me a code review checklist for this component" → code_review_checklist

• "Show me what I'm about to commit" → generate_commit_message

Development

# Install dependencies
npm install

# Verify syntax
npm run lint

# Run server (stays open on stdio)
npm start

Requirements

• Node.js 18+ (uses native modules: fs, path, child_process)

• Git (for git_info and generate_commit_message tools)

Security

• Path traversal prevention: All file paths validated against project root

• Graceful degradation: All tools handle errors without crashing

• No injection risks: Git commands use template literals with args (safe in Node.js 22+), patterns validated with zod

• Buffer limits: Large diffs capped at 3000 bytes preview; maxBuffer set to 10MB for git commands

• Stdio-only: Server uses stdio transport (no network exposure)