dev-workflow-mcp
Provides tools to inspect Git repository state, including current branch, git status, last 10 commits, and staged changes for commit message generation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@dev-workflow-mcp what's the current git status?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 installRelated MCP server: AI Developer Workspace MCP Server
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
Tool | Description |
| Reads and returns the full contents of a file by relative path. |
| Lists files/folders recursively from a directory, up to a given depth. |
| Searches for a text or regex pattern across |
| Returns current branch, |
| Returns a checklist tailored to |
| Retrieves staged changes and formats them with a conventional commit template. |
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 startRequirements
Node.js 18+ (uses native modules:
fs,path,child_process)Git (for
git_infoandgenerate_commit_messagetools)
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;
maxBufferset to 10MB for git commandsStdio-only: Server uses stdio transport (no network exposure)
Available Tools
6 toolscode_review_checklistCode Review ChecklistA
Returns a tailored code review checklist for a file, based on whether it's React code, API/backend code, or general-purpose code. Use this before or after editing a file to review it systematically.
Inputs: type (required), filepath (required).
generate_commit_messageGenerate Commit MessageB
Retrieves all staged changes (git diff --staged) and formats them cleanly. Use this to review what's staged before writing a conventional commit message.
Inputs: no named parameters.
git_infoGit InfoA
Returns the current git branch, working tree status, and the last 10 commits for the project. Use this to check repository state before making changes or committing.
Inputs: no named parameters.
list_project_structureList Project StructureA
Lists files and folders recursively starting from a directory in the project, up to a given depth. Use this to orient yourself in the project layout before editing or searching.
Inputs: depth, directory.
read_project_fileRead Project FileA
Reads and returns the full contents of a file in the current project, given a path relative to the project root. Use this to inspect a specific file's contents before editing or discussing it.
Inputs: filepath (required).
search_codeSearch CodeA
Searches for a text pattern (plain substring or regex) across all .js, .ts, .tsx, and .jsx files under a directory. Use this to find where a function, variable, string, or pattern is used in the codebase.
Inputs: pattern (required), directory.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct action and resource: reading a file, listing structure, searching code, checking git state, getting a review checklist, and generating a commit message. The only mild overlap is between git_info and generate_commit_message, both touching repository state, but their descriptions clearly separate status inspection from staged-diff retrieval.
Most tools follow a clear verb_noun pattern (read_project_file, list_project_structure, search_code, generate_commit_message). Two deviate to noun phrases (git_info, code_review_checklist), which is a minor inconsistency but still readable and predictable.
Six tools is well-scoped for a focused dev-workflow helper, with each tool covering a distinct facet of inspecting and preparing code changes. No redundant or filler tools pad the set.
The surface covers reading, searching, git inspection, and review/commit prep, but it has no write or edit operations despite descriptions referencing 'before editing' and 'before committing' changes. There is no tool to actually apply edits or perform the commit, leaving a notable lifecycle gap.
Maintenance
Related MCP Connectors
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
Claude Code / MCP skills for the dev pipeline: discover, spec, design, build, ship, operate.
Path-scoped team memories, rules and skills for Claude Code, Cursor, Codex and other MCP clients.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude Web to securely inspect, search, and modify local project files through a sandboxed MCP server with atomic writes, path traversal protection, and sensitive file blocking.MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to manage local project files and Git operations through MCP tools, including file CRUD, search, Git status, recent commits, and project summaries.-
- AlicenseNot gradedqualityCmaintenanceEnables Claude Code to query a local, import-aware graph of a repository, so questions like who calls a function, what breaks if it changes, and what imports a file are answered in one lookup instead of a search-and-read loop. It also persists durable session notes and offers full-text search over past session transcripts, all through MCP tools.30 PyPIMIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude Code and Codex assistants to research and read/write a team's knowledge base, manage projects and files, and use integrations through MCP tools.Apache 2.0