MCP DevTools
๐ ๐ ๐ ๐ช ๐ง - Production-grade MCP server for secure access to local dev environments (fil
What is MCP DevTools?
MCP DevTools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐ ๐ ๐ ๐ช ๐ง - production-grade mcp server for secure access to local dev environments (fil
๐ ๐ ๐ ๐ช ๐ง - Production-grade MCP server for secure access to local dev environments (fil
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP protocol support
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @oscarmarin/mcp-devtoolsManual Installation
npx -y @oscarmarin/mcp-devtoolsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP DevTools
MCP DevTools is a production-grade MCP server that gives AI agents secure, scoped access to local development environments across macOS, Windows, and Linux. It exposes 14 tools covering filesystem operations (read, write, search), database queries, process management, log reading, environment inspection, and OpenAPI endpoint calls โ all protected by filesystem scope boundaries, command allowlists, audit logging, and secret masking. It is designed for AI coding agents like Claude, Cursor, and Copilot that need to interact safely with a developer's local machine without unrestricted system access.
Prerequisites
- Node.js 18+ installed (for npx usage)
- An MCP-compatible client such as Claude Desktop, Cursor, or Cline
- Optional: a local database accessible for the database query tools
- Optional: an MCP_AUTH_TOKEN environment variable if using HTTP transport with authentication
Run with npx (zero install)
The server can be run immediately with npx in stdio mode, which is the recommended approach for Claude Desktop integration. No global install is needed.
npx @oscarmarin/mcp-devtoolsConfigure Claude Desktop
Add the server to your Claude Desktop claude_desktop_config.json file using the npx command. The server uses zero-config defaults with sensible security boundaries.
{
"mcpServers": {
"devtools": {
"command": "npx",
"args": ["-y", "@oscarmarin/mcp-devtools"]
}
}
}Configure custom settings (optional)
Create a mcp-devtools.json file in your project root or home directory to customize filesystem scope, allowed commands, database connections, or HTTP transport settings. The server uses cosmiconfig for discovery.
{
"transport": "stdio",
"filesystem": {
"allowedPaths": ["/home/user/projects"]
},
"commands": {
"allowlist": ["npm", "git", "node"]
}
}Enable HTTP transport with authentication (optional)
For remote access scenarios, configure HTTP transport with Bearer token authentication.
{
"transport": "http",
"port": 3333,
"auth": {
"token": "env:MCP_AUTH_TOKEN"
}
}Use built-in prompts for common dev tasks
MCP DevTools ships with predefined MCP prompts for common workflows: debug_error, code_review, explore_codebase, and refactor_function. Trigger these through your AI client.
MCP DevTools Examples
Client configuration
Claude Desktop configuration for MCP DevTools using npx with zero-config defaults.
{
"mcpServers": {
"devtools": {
"command": "npx",
"args": ["-y", "@oscarmarin/mcp-devtools"]
}
}
}Prompts to try
Example tasks you can ask your AI assistant to perform using MCP DevTools.
- "Read the file at /home/user/projects/myapp/src/index.ts"
- "Search for all files containing 'TODO' in /home/user/projects/myapp"
- "List the tables in my local PostgreSQL database"
- "Run git status in /home/user/projects/myapp and show me what has changed"
- "Review the code in /home/user/projects/myapp/src/auth.ts for security issues"Troubleshooting MCP DevTools
File access denied or path not allowed error
The server enforces filesystem scope boundaries. Create or update mcp-devtools.json with an allowedPaths array that includes the directories your AI agent needs to access.
Command execution blocked by allowlist
By default, only a safe set of commands is permitted. Add the command to the allowlist array in your mcp-devtools.json configuration file under the commands key.
HTTP transport connection refused or authentication failure
Ensure the server is running and the port (default 3333) is not blocked. Set the MCP_AUTH_TOKEN environment variable to the same value referenced in your config's auth.token field before starting the server.
Frequently Asked Questions about MCP DevTools
What is MCP DevTools?
MCP DevTools is a Model Context Protocol (MCP) server that ๐ ๐ ๐ ๐ช ๐ง - production-grade mcp server for secure access to local dev environments (fil It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP DevTools?
Install via npm with the command: npx -y @oscarmarin/mcp-devtools. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with MCP DevTools?
MCP DevTools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP DevTools free to use?
Yes, MCP DevTools is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
MCP DevTools Alternatives โ Similar Developer Tools Servers
Looking for alternatives to MCP DevTools? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
โ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
โ 155.8kJava ้ข่ฏ & ๅ็ซฏ้็จ้ข่ฏๆๅ๏ผ่ฆ็่ฎก็ฎๆบๅบ็กใๆฐๆฎๅบใๅๅธๅผใ้ซๅนถๅใ็ณป็ป่ฎพ่ฎกไธ AI ๅบ็จๅผๅ
Gemini CLI
โ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
โ 87.3kโญ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
โ 86.0kModel Context Protocol Servers
CC Switch
โ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP DevTools in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP DevTools?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.