Skip to content

About

A modular MCP server that provides commonly used developer tools for AI coding agents

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

154 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MCP DevTools

A single, high-performance MCP server that replaces many Node.js and Python-based MCP servers with one efficient Go binary, providing access to essential developer tools through a unified, modular interface that can be easily extended with new tools.

Default Tools

graph LR
    A[MCP DevTools<br>Server]

    A --> B[Search &<br>Discovery]
    A --> E[Intelligence &<br>Memory]
    A --> F[Utilities]

    B --> B_Tools[🌐 Internet Search<br>📡 Web Fetch<br>📦 Package Search<br>📚 Package Documentation<br>🐙 GitHub]

    E --> E_Tools[🧠 Think Tool]

    F --> F_Tools[🧮 Calculator<br>🕵 Find Long Files]

    classDef components fill:#E6E6FA,stroke:#756BB1,color:#756BB1
    classDef decision fill:#FFF5EB,stroke:#FD8D3C,color:#E6550D
    classDef data fill:#EFF3FF,stroke:#9ECAE1,color:#3182BD
    classDef process fill:#EAF5EA,stroke:#C6E7C6,color:#77AD77

    class A components
    class B,B_Tools decision
    class E,E_Tools data
    class F,F_Tools process
Loading

Additional Tools (Disabled by Default)

graph LR
    A[MCP DevTools<br>Server]

    A --> B[Search &<br>Discovery]
    A --> C[Document<br>Processing]
    A --> E[Intelligence &<br>Memory]
    A --> F[Utilities]
    A --> G[Agents]
    A --> D[UI Component<br>Libraries]
    A --> H[MCP]

    B --> B_Tools[📝 Terraform Docs]

    C --> C_Tools[📄 Document Processing<br>📈 Excel Spreadsheets<br>📑 PDF Processing]

    E --> E_Tools[🔢 Sequential Thinking<br>🕸️ Memory Graph]

    F --> F_Tools[🇬🇧 American→English<br>🔌 API Integrations<br>📁 Filesystem<br>✂️ Code Skim<br>🔍 Code Search<br>🏷️ Code Rename]

    G --> G_Tools[🤖 Claude Code<br>🎯 Codex CLI<br>🐙 Copilot CLI<br>✨ Gemini CLI<br>👻 Kiro]

    D --> D_Tools[🎨 ShadCN UI<br>✨ Magic UI<br>⚡ Aceternity UI]

    H --> H_Proxy[🌐 MCP Proxy]

    classDef components fill:#E6E6FA,stroke:#756BB1,color:#756BB1
    classDef llm fill:#E5F5E0,stroke:#31A354,color:#31A354
    classDef process fill:#EAF5EA,stroke:#C6E7C6,color:#77AD77
    classDef data fill:#EFF3FF,stroke:#9ECAE1,color:#3182BD
    classDef decision fill:#FFF5EB,stroke:#FD8D3C,color:#E6550D
    classDef api fill:#FFF5F0,stroke:#FD9272,color:#A63603
    classDef ui fill:#F3E5F5,stroke:#AB47BC,color:#8E24AA

    class A components
    class B,B_Tools decision
    class C,C_Tools api
    class D,D_Tools ui
    class E,E_Tools data
    class F,F_Tools process
    class G,G_Tools llm
    class H_Proxy api
Loading

Why I Built MCP DevTools

🚀 Single Binary Solution

  • Replace multiple potentially resource-heavy Node.js/Python MCP servers, each spawned for every client tool you use
  • One binary, one configuration, consistent performance
  • Built in Go for speed and efficiency and because I'm not smart enough to write Rust
  • Minimal memory footprint compared to multiple separate servers
  • Fast startup and response times
  • Download one binary, configure once - or compile from source
  • Works out of the box for most tools
  • OpenTelemetry support for tracing and metrics

🛠 Comprehensive Tool Suite For Agentic Coding

  • 20+ essential developer agent tools in one package
  • No need to manage multiple MCP server installations
  • Consistent API across all tools
  • Modular design with tool registry allowing for easy addition of new tools

Quickstart

Quick Install / Update

If you have Golang installed, simply run go install github.com/sammcj/mcp-devtools@HEAD and it will be installed to your $GOPATH/bin.

There is also an experimental installer script:

curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash

This will:

  • Download the latest release and installs to an appropriate location (respects $GOPATH/bin or uses ~/.local/bin)
  • Remove macOS quarantine attributes automatically
  • Generate example MCP client configurations in ~/.mcp-devtools/examples/
  • Open your file manager to show the example configs and show you where to configure your MCP clients
🔗 Quick Install Customisation (Click Here)

Customisation:

# Dry run (shows what would be done without making changes)
DRY_RUN=1 curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash

# Install to a specific directory
INSTALL_DIR=/custom/path curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash

# Install a specific version
VERSION=0.50.0 curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash

# Skip example config generation
NO_CONFIG=1 curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash

# Skip all confirmation prompts (for automation)
FORCE=1 curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash

Manual Installation

🔗 Manual Installation (Click Here)

You have a few other options to make MCP DevTools available to your MCP clients:

  1. go If you have Golang installed
  2. If you do not have, and do not want to install Golang

If you have Golang installed

Golang option 1: Use the automated installer

The automated installer works great even if you have Golang installed:

curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash

This will respect your $GOPATH/bin if it's in your PATH, and automatically configure example MCP client settings.

Golang option 2: Download at runtime

Note that while go run makes it easy to get started, it means every time your client starts to download the tool may not be what you want in the long run.

MCP Client Configuration:

{
  "mcpServers": {
    "dev-tools": {
      "type": "stdio",
      "command": "go",
      "args": ["run", "github.com/sammcj/mcp-devtools@HEAD"],
      "env": {
        "ENABLE_ADDITIONAL_TOOLS": "security,sequential_thinking,code_skim,code_rename",
        "DISABLED_TOOLS": "",
        "NOTE_FOR_HUMANS": "A minimal set of tools are enabled by default, MCP DevTools provides many additional useful tools including efficient Context7 documentation search, Frontend UI Framework templates, Code search and optimisation and many others, visit https://github.com/sammcj/mcp-devtools for more information on available tools and configuration"
      }
    }
  }
}

Or if you're using Claude Code you can also add it via the CLI:

claude mcp add --transport stdio mcp-devtools go run github.com/sammcj/mcp-devtools@HEAD
  • Add MCP DevTools to LM Studio (Requires Golang installed)
  • Install in VS Code (Requires Golang installed)

Golang option 3: Download, then run

🔗 Click here for instructions
  1. Install the latest MCP DevTools binary:
go install github.com/sammcj/mcp-devtools@HEAD
echo "${GOPATH}/bin/mcp-devtools" # Use this path in your MCP configuration, if your GOPATH is not set, please check your Go installation / configuration.

# If you're on macOS, you'll also need to run the following command to allow the downloaded binary to run:
xattr -r -d com.apple.quarantine ${GOPATH}/bin/mcp-devtools
  1. Update your MCP client to add the MCP DevTools server configuration, replacing /path/to/mcp-devtools with the actual path to the binary (e.g. /Users/samm/go/bin/mcp-devtools):
{
  "mcpServers": {
    "dev-tools": {
      "type": "stdio",
      "command": "/path/to/mcp-devtools",
      "env": {
        "ENABLE_ADDITIONAL_TOOLS": "security,sequential_thinking,code_skim,code_rename",
        "DISABLED_TOOLS": "",
        "NOTE_FOR_HUMANS": "A minimal set of tools are enabled by default, MCP DevTools provides many additional useful tools including efficient Context7 documentation search, Frontend UI Framework templates, Code search and optimisation and many others, visit https://github.com/sammcj/mcp-devtools for more information on available tools and configuration"
      }
    }
  }
}
  • Add MCP Server dev-tools to LM Studio
  • Install in VS Code

If you do not have Golang installed

🔗 Click here for instructions

If you do not have, and do not want to install Golang, you can download the latest release binary from the releases page.

# If you're on macOS, you'll also need to run the following command to allow the downloaded binary to run:
xattr -r -d com.apple.quarantine mcp-devtools

Configure your MCP client to use the downloaded binary (replacing /path/to/mcp-devtools ):

{
  "mcpServers": {
    "dev-tools": {
      "type": "stdio",
      "command": "/path/to/mcp-devtools",
      "env": {
        "ENABLE_ADDITIONAL_TOOLS": "security,sequential_thinking,code_skim,code_rename",
        "DISABLED_TOOLS": "",
        "NOTE_FOR_HUMANS": "A minimal set of tools are enabled by default, MCP DevTools provides many additional useful tools including efficient Context7 documentation search, Frontend UI Framework templates, Code search and optimisation and many others, visit https://github.com/sammcj/mcp-devtools for more information on available tools and configuration"
      }
    }
  }
}
  • Add MCP Server dev-tools to LM Studio
  • Install in VS Code

Available Tools

These tools can be disabled by adding their function name to the DISABLED_TOOLS environment variable in your MCP configuration.

Tool Purpose Dependencies Example Usage Maturity
Internet Search Multi-provider internet search None (Provider keys optional) Web, image, news, video search 🟢
Web Fetch Retrieve internet content as Markdown None Documentation and articles 🟢
Package Documentation Context7 library documentation lookup None React, modelcontextprotocol/go-sdk 🟢
Package Search Check package versions None NPM, Python, Go, Java, Docker 🟢
Think Structured reasoning space None Complex problem analysis 🟢
Calculator Basic arithmetic calculations None 2 + 3 * 4, batch processing 🟢
DevTools Help Extended info about DevTools tools None Usage examples, troubleshooting 🟢
Find Long Files Identify files needing refactoring Find files over 700 lines 🟢
Sequential Thinking Structured multi-step reasoning None Step-by-step analysis (stdio only) 🟢

Additional Tools (Disabled By Default)

These tools can be enabled by setting the ENABLE_ADDITIONAL_TOOLS environment variable in your MCP configuration.

Tool Purpose ENABLE_ADDITIONAL_TOOLS Example Usage Maturity
GitHub GitHub repositories and data github Issues, PRs, repos, cloning 🟢
Code Skim Return code structure without implementation details code_skim Reduced token consumption 🟢
Code Search Semantic code search with local embeddings code_search Find code by natural language description 🟠
Code Rename LSP-based symbol renaming across files (experimental) code_rename Rename functions, variables, types 🟠
Memory Persistent knowledge graphs memory Store entities and relationships 🟡
Document Processing Convert documents to Markdown process_document PDF, DOCX → Markdown with OCR 🟡
PDF Processing Fast PDF text extraction pdf Quick PDF to Markdown 🟢
Excel Excel file manipulation excel Workbooks, charts, pivot tables, formulas 🟢
Terraform Documentation Terraform Registry API (providers, modules, and policies) terraform_documentation Provider docs, module search, policy lookup 🟡
Filesystem File and directory operations filesystem Read, write, edit, search files 🟡
MCP Proxy Proxies MCP requests to upstream HTTP MCP se

About

A modular MCP server that provides commonly used developer tools for AI coding agents

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages