Getting Started

Installation

No installation required — run directly with npx:

npx @oscarmarin/mcp-devtools

Or install globally:

npm install -g @oscarmarin/mcp-devtools

Configure Your MCP Client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor

Edit ~/.cursor/mcp.json:

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

HTTP Transport

For remote or containerized use, create mcp-devtools.json in your project root:

{
  "transport": "http",
  "port": 3333,
  "auth": {
    "token": "env:MCP_AUTH_TOKEN"
  }
}

Then start:

MCP_AUTH_TOKEN=my-secret npx @oscarmarin/mcp-devtools

The endpoint will be at http://localhost:3333.

Verify

Once connected, ask your AI agent:

"List the files in this directory"

It should invoke list_directory and return the contents of your project.

Next Steps

• Configuration — customize scope, databases, commands
• Tools Reference — full tool documentation
• Plugins — extend with custom tools
• Security — understand the safety model