MCP DevTools
A Model Context Protocol (MCP) server that provides useful developer tools for local development.
MCP DevTools is built with the official MCP Go SDK and exposes a collection of tools through a standardized interface, allowing AI assistants and other MCP clients to interact with your local development environment.
Features
This MCP server provides the following tools:
🎨 Color Utilities
color_convert- Convert CSS color values between various formats- Input: CSS color value (e.g.,
#ff5733,rgb(255, 87, 51),hsl(9, 100%, 60%), or named colors likered) - Output: Hex, RGB, HSL, HSV, CMYK, LAB, XYZ, Linear RGB representations
- Additional: Luminance value and light/dark classification
🌐 Network Utilities
get_ip_address- Get the current computer's IP addresses- Returns: All active network interface IP addresses
- Identifies: Primary IP address (first non-loopback IPv4)
🕐 Time Utilities
get_current_time- Get the current server time- Returns: Current time in RFC1123 format
📁 File System Utilities
list_old_downloads- Find old files in Downloads folder- Returns: List of files in the Downloads directory that haven't been modified in the last 3 months
- Includes: File name, last modified time, and size
💻 System Utilities
list_installed_apps- List installed applications- Platform: Currently supports macOS only
- Returns: List of installed applications from
/Applicationsdirectory
🌍 Browser Utilities
open_in_browser- Open URLs in the default browser- Input: URL to open
- Platforms: Windows, macOS, Linux
- Action: Opens the specified URL in the system's default web browser
Installation
Option 1: Shell Script (Mac/Linux)```bash
curl -fsSL https://github.com/release-lab/install/raw/v1/install.sh | bash -s -- -r=axetroy/mcp-server-devtools -e=mcp-server-devtools
### Option 2: PowerShell (Windows)```powershell
$r="axetroy/mcp-server-devtools";$e="mcp-server-devtools";iwr https://github.com/release-lab/install/raw/v1/install.ps1 -useb | iex
Option 3: Download Binary
Download the pre-built executable from the GitHub Releases page and add it to your $PATH.
Option 4: Build from Source
Requires Go 1.21 or later:```bash
go install github.com/axetroy/mcp-server-devtools/cmd/mcp-server-devtools@latest
## Configuration
To use this server with an MCP client, add it to your client's configuration file.
### Claude Desktop
Add to your Claude Desktop configuration file:
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json````json
{
"mcpServers": {
"devtools": {
"command": "mcp-server-devtools"
}
}
}
Other MCP Clients
For other MCP clients, configure them to run:```bash
mcp-server-devtools
The server communicates via stdin/stdout following the Model Context Protocol specification.
## Usage
Once configured, your MCP client can use the available tools. The server will:
1. Start when the MCP client initializes
2. Wait for tool call requests on stdin
3. Execute the requested tool
4. Return results via stdout
### Example Tool Calls
Color Conversion
Request:```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "color_convert",
"arguments": {
"color": "#ff5733"
}
}
}
Response:```json
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hex": "#ff5733",
"rgb": "rgb(255, 87, 51)",
"hsl": "hsl(9.0, 100.0%, 60.0%)",
"hsv": "hsv(9.0, 80.0%, 100.0%)",
"cmyk": "cmyk(0.0%, 65.9%, 80.0%, 0.0%)",
"lab": "lab(61.57, 56.45, 51.48)",
"xyz": "xyz(0.469, 0.305, 0.074)",
"linear_rgb": "linear-rgb(1.000, 0.106, 0.030)",
"luminance": 0.428,
"is_light": false,
"is_dark": true,
"original": "#ff5733"
}
}
Get IP Address
Request:```json
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "get_ip_address",
"arguments": {}
}
}
Response:```json
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"addresses": ["192.168.1.100", "fe80::1"],
"primary": "192.168.1.100"
}
}
## Development
### Build```bash
make build
Test```bash
make test
### Format Code```bash
make format
Local Development with MCP Client
For local development and testing with an MCP client, you can configure it to run the server from source:json
{
"mcpServers": {
"devtools": {
"command": "go",
"args": ["run", "cmd/mcp-server-devtools/main.go"],
"cwd": "/path/to/mcp-server-devtools"
}
}
}
License
The MIT License
