[ mcp-devtools ]

Production-grade MCP server that gives AI agents safe access to your local dev environment: filesystem, databases, processes, and OpenAPI specs.

npm version CI MIT License
GitHub npm
npx @oscarmarin/mcp-devtools zero config required

13 Tools, 4 Categories

Filesystem

  • read_file Read text files with optional line range
  • write_file Atomic writes within scope
  • list_directory Recursive listing with glob filters
  • search_files Grep-like search with context lines
  • get_file_info Metadata, MIME type, line count

Database

  • query_db Parameterized SQL with read-only guard
  • list_tables List tables and views
  • describe_table Column metadata across engines

Supports PostgreSQL, MySQL, and SQLite

Process

  • run_command Allowlisted command execution
  • read_logs Tail logs with regex filtering
  • get_env Environment variables with secret masking

OpenAPI

  • parse_openapi Parse specs and extract operations
  • call_api Execute requests by operationId

OpenAPI 3.x and Swagger 2.0

Two Transport Modes

stdio default

Standard MCP transport for Claude Desktop, Cursor, Continue, and Copilot.

{
  "mcpServers": {
    "devtools": {
      "command": "npx",
      "args": ["-y", "@oscarmarin/mcp-devtools"]
    }
  }
}

HTTP new

Streamable HTTP for remote or containerized MCP clients.

// mcp-devtools.json
{
  "transport": "http",
  "port": 3333
}

// then run:
// npx @oscarmarin/mcp-devtools

Security First

Documentation

Full per-tool reference documentation is available in the GitHub repository:

Getting Started Guide  ·  Configuration Reference  ·  Contributing