Skip to content
Back to search

mcp-devtools

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/sammcj/mcp-devtools with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/sammcj/mcp-devtools'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sammcj--mcp-devtools/badge.svg)](/listings/sammcj--mcp-devtools)

HTML

<a href="/listings/sammcj--mcp-devtools"><img src="/api/listings/sammcj--mcp-devtools/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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

<details> <summary><b>๐Ÿ”— Quick Install Customisation (Click Here)</b></summary>

**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

</details>

Manual Installation

<details> <summary><b>๐Ÿ”— Manual Installation (Click Here)</b></summary>

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

1. <img src="screenshots/go-icon.png" alt="go" width="20"/> If you have Golang installed 2. [If you do not have, and do not want to install Golang](#if-you-do-not-have-golang-installed)

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md ยท README ยท 700 lines ยท 7 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP DevTools
  2. 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.
  3. **Default Tools**
  4. ```mermaid
  5. graph LR
  6. A[MCP DevTools<br>Server]
  7. A --> B[Search &<br>Discovery]
  8. A --> E[Intelligence &<br>Memory]
  9. A --> F[Utilities]
  10. B --> B_Tools[๐ŸŒ Internet Search<br>๐Ÿ“ก Web Fetch<br>๐Ÿ“ฆ Package Search<br>๐Ÿ“š Package Documentation<br>๐Ÿ™ GitHub]
  11. E --> E_Tools[๐Ÿง  Think Tool]
  12. F --> F_Tools[๐Ÿงฎ Calculator<br>๐Ÿ•ต Find Long Files]
  13. classDef components fill:#E6E6FA,stroke:#756BB1,color:#756BB1
  14. classDef decision fill:#FFF5EB,stroke:#FD8D3C,color:#E6550D
  15. classDef data fill:#EFF3FF,stroke:#9ECAE1,color:#3182BD
  16. classDef process fill:#EAF5EA,stroke:#C6E7C6,color:#77AD77
  17. class A components
  18. class B,B_Tools decision
  19. class E,E_Tools data
  20. class F,F_Tools process
  21. ```
  22. **Additional Tools (Disabled by Default)**
  23. ```mermaid
  24. graph LR
  25. A[MCP DevTools<br>Server]
  26. A --> B[Search &<br>Discovery]
  27. A --> C[Document<br>Processing]
  28. A --> E[Intelligence &<br>Memory]
  29. A --> F[Utilities]
  30. A --> G[Agents]
  31. A --> D[UI Component<br>Libraries]
  32. A --> H[MCP]
  33. B --> B_Tools[๐Ÿ“ Terraform Docs]
  34. C --> C_Tools[๐Ÿ“„ Document Processing<br>๐Ÿ“ˆ Excel Spreadsheets<br>๐Ÿ“‘ PDF Processing]
  35. E --> E_Tools[๐Ÿ”ข Sequential Thinking<br>๐Ÿ•ธ๏ธ Memory Graph]
  36. F --> F_Tools[๐Ÿ‡ฌ๐Ÿ‡ง Americanโ†’English<br>๐Ÿ”Œ API Integrations<br>๐Ÿ“ Filesystem<br>โœ‚๏ธ Code Skim<br>๐Ÿ” Code Search<br>๐Ÿท๏ธ Code Rename]
  37. G --> G_Tools[๐Ÿค– Claude Code<br>๐ŸŽฏ Codex CLI<br>๐Ÿ™ Copilot CLI<br>โœจ Gemini CLI<br>๐Ÿ‘ป Kiro]
  38. D --> D_Tools[๐ŸŽจ ShadCN UI<br>โœจ Magic UI<br>โšก Aceternity UI]
  39. H --> H_Proxy[๐ŸŒ MCP Proxy]
  40. classDef components fill:#E6E6FA,stroke:#756BB1,color:#756BB1
  41. classDef llm fill:#E5F5E0,stroke:#31A354,color:#31A354
  42. classDef process fill:#EAF5EA,stroke:#C6E7C6,color:#77AD77
  43. classDef data fill:#EFF3FF,stroke:#9ECAE1,color:#3182BD
  44. classDef decision fill:#FFF5EB,stroke:#FD8D3C,color:#E6550D
  45. classDef api fill:#FFF5F0,stroke:#FD9272,color:#A63603
  46. classDef ui fill:#F3E5F5,stroke:#AB47BC,color:#8E24AA
  47. class A components
  48. class B,B_Tools decision
  49. class C,C_Tools api
  50. class D,D_Tools ui
  51. class E,E_Tools data
  52. class F,F_Tools process
  53. class G,G_Tools llm
  54. class H_Proxy api
  55. ```
  56. ## Why I Built MCP DevTools
  57. **๐Ÿš€ Single Binary Solution**
  58. - Replace multiple potentially resource-heavy Node.js/Python MCP servers, each spawned for every client tool you use
  59. - One binary, one configuration, consistent performance
  60. - Built in Go for speed and efficiency and because I'm not smart enough to write Rust
  61. - Minimal memory footprint compared to multiple separate servers
  62. - Fast startup and response times
  63. - Download one binary, configure once - or compile from source
  64. - Works out of the box for most tools
  65. - OpenTelemetry support for tracing and metrics
  66. **๐Ÿ›  Comprehensive Tool Suite For Agentic Coding**
  67. - 20+ essential developer agent tools in one package
  68. - No need to manage multiple MCP server installations
  69. - Consistent API across all tools
  70. - Modular design with tool registry allowing for easy addition of new tools
  71. ## Quickstart
  72. ### Quick Install / Update
  73. If you have Golang installed, simply run `go install github.com/sammcj/mcp-devtools@HEAD` and it will be installed to your $GOPATH/bin.
  74. There is also an experimental installer script:
  75. ```bash
  76. curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 107 on GitHub
  77. ```
  78. This will:
  79. - Download the latest release and installs to an appropriate location (respects `$GOPATH/bin` or uses `~/.local/bin`)
  80. - Remove macOS quarantine attributes automatically
  81. - Generate example MCP client configurations in `~/.mcp-devtools/examples/`
  82. - Open your file manager to show the example configs and show you where to configure your MCP clients
  83. <details>
  84. <summary><b>๐Ÿ”— Quick Install Customisation (Click Here)</b></summary>
  85. **Customisation:**
  86. ```bash
  87. # Dry run (shows what would be done without making changes)
  88. DRY_RUN=1 curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 124 on GitHub
  89. # Install to a specific directory
  90. INSTALL_DIR=/custom/path curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 127 on GitHub
  91. # Install a specific version
  92. VERSION=0.50.0 curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 130 on GitHub
  93. # Skip example config generation
  94. NO_CONFIG=1 curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 133 on GitHub
  95. # Skip all confirmation prompts (for automation)
  96. FORCE=1 curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 136 on GitHub
  97. ```
  98. </details>
  99. ### Manual Installation
  100. <details>
  101. <summary><b>๐Ÿ”— Manual Installation (Click Here)</b></summary>
  102. You have a few other options to make MCP DevTools available to your MCP clients:
  103. 1. <img src="screenshots/go-icon.png" alt="go" width="20"/> If you have Golang installed
  104. 2. [If you do not have, and do not want to install Golang](#if-you-do-not-have-golang-installed)
  105. ### If you have Golang installed
  106. #### Golang option 1: Use the automated installer
  107. The automated installer works great even if you have Golang installed:
  108. ```bash
  109. curl -fsSL https://raw.githubusercontent.com/sammcj/mcp-devtools/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 158 on GitHub
  110. ```
  111. This will respect your `$GOPATH/bin` if it's in your PATH, and automatically configure example MCP client settings.
  112. #### Golang option 2: Download at runtime
  113. 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.
  114. MCP Client Configuration:
  115. ```json
  116. {
  117. "mcpServers": {
  118. "dev-tools": {
  119. "type": "stdio",
  120. "command": "go",
  121. "args": ["run", "github.com/sammcj/mcp-devtools@HEAD"],
  122. "env": {
  123. "ENABLE_ADDITIONAL_TOOLS": "security,sequential_thinking,code_skim,code_rename",
  124. "DISABLED_TOOLS": "",
  125. "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"
  126. }
  127. }
  128. }
  129. }
  130. ```
  131. Or if you're using Claude Code you can also add it via the CLI:
  132. ```bash
  133. claude mcp add --transport stdio mcp-devtools go run github.com/sammcj/mcp-devtools@HEAD
  134. ```
  135. - [![Add MCP DevTools to LM Studio (Requires Golang installed)](https://files.lmstudio.ai/deeplink/mcp-install-dark.svg)](https://lmstudio.ai/install-mcp?name=dev-tools&config=eyJjb21tYW5kIjoiZ28iLCJhcmdzIjpbInJ1biIsImh0dHBzOi8vZ2l0aHViLmNvbS9zYW1tY2ovbWNwLWRldnRvb2xzQEhFQUQiXSwiZW52Ijp7IkVOQUJMRV9BRERJVElPTkFMX1RPT0xTIjoic2VjdXJpdHksc2VxdWVudGlhbF90aGlua2luZyxnaXRodWIsZ2V0X3Rvb2xfaGVscCIsIkRJU0FCTEVEX1RPT0xTIjoic2VhcmNoX3BhY2thZ2VzLHJlc29sdmVfbGlicmFyeV9pZCxnZXRfbGlicmFyeV9kb2N1bWVudGF0aW9uIiwiTk9URV9GT1JfSFVNQU5TIjoiQSBtaW5pbWFsIHNldCBvZiB0b29scyBhcmUgZW5hYmxlZCBieSBkZWZhdWx0LCBNQ1AgRGV2VG9vbHMgcHJvdmlkZXMgbWFueSBhZGRpdGlvbmFsIHVzZWZ1bCB0b29scyBpbmNsdWRpbmcgZWZmaWNpZW50IENvbnRleHQ3IGRvY3VtZW50YXRpb24gc2VhcmNoLCBGcm9udGVuZCBVSSBGcmFtZXdvcmsgdGVtcGxhdGVzLCBDb2RlIHNlYXJjaCBhbmQgb3B0aW1pc2F0aW9uIGFuZCBtYW55IG90aGVycywgdmlzaXQgaHR0cHM6Ly9naXRodWIuY29tL3NhbW1jai9tY3AtZGV2dG9vbHMgZm9yIG1vcmUgaW5mb3JtYXRpb24gb24gYXZhaWxhYmxlIHRvb2xzIGFuZCBjb25maWd1cmF0aW9uIn19)
  136. - [![Install in VS Code (Requires Golang installed)](https://img.shields.io/badge/VS_Code-Install_dev--tools-0098FF?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22dev-tools%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22go%22%2C%22args%22%3A%5B%22run%22%2C%22https%3A%2F%2Fgithub.com%2Fsammcj%2Fmcp-devtools%40HEAD%22%5D%2C%22env%22%3A%7B%22ENABLE_ADDITIONAL_TOOLS%22%3A%22security%2Csequential_thinking%2Ccode_skim%2Ccode_rename%22%2C%22DISABLED_TOOLS%22%3A%22search_packages%2Cresolve_library_id%2Cget_library_documentation%22%2C%22NOTE_FOR_HUMANS%22%3A%22A%20minimal%20set%20of%20tools%20are%20enabled%20by%20default%2C%20MCP%20DevTools%20provides%20many%20additional%20useful%20tools%20including%20efficient%20Context7%20documentation%20search%2C%20Frontend%20UI%20Framework%20templates%2C%20Code%20search%20and%20optimisation%20and%20many%20others%2C%20visit%20https%3A%2F%2Fgithub.com%2Fsammcj%2Fmcp-devtools%20for%20more%20information%20on%20available%20tools%20and%20configuration%22%7D%7D)
  137. #### Golang option 3: Download, then run
  138. <details>
  139. <summary><b>๐Ÿ”— Click here for instructions</b></summary>
  140. 1. Install the latest MCP DevTools binary:
  141. ```shell
  142. go install github.com/sammcj/mcp-devtools@HEAD
  143. echo "${GOPATH}/bin/mcp-devtools" # Use this path in your MCP configuration, if your GOPATH is not set, please check your Go installation / configuration.
  144. # If you're on macOS, you'll also need to run the following command to allow the downloaded binary to run:
  145. xattr -r -d com.apple.quarantine ${GOPATH}/bin/mcp-devtools
  146. ```
  147. 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`):
  148. ```json
  149. {
  150. "mcpServers": {
  151. "dev-tools": {
  152. "type": "stdio",
  153. "command": "/path/to/mcp-devtools",
  154. "env": {
  155. "ENABLE_ADDITIONAL_TOOLS": "security,sequential_thinking,code_skim,code_rename",
  156. "DISABLED_TOOLS": "",
  157. "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"
  158. }
  159. }
  160. }
  161. }
  162. ```
  163. - [![Add MCP Server dev-tools to LM Studio](https://files.lmstudio.ai/deeplink/mcp-install-dark.svg)](https://lmstudio.ai/install-mcp?name=dev-tools&config=eyJjb21tYW5kIjoiL3BhdGgvdG8vbWNwLWRldnRvb2xzIiwiZW52Ijp7IkVOQUJMRV9BRERJVElPTkFMX1RPT0xTIjoic2VjdXJpdHksc2VxdWVudGlhbF90aGlua2luZyxnaXRodWIsZ2V0X3Rvb2xfaGVscCIsIkRJU0FCTEVEX1RPT0xTIjoic2VhcmNoX3BhY2thZ2VzLHJlc29sdmVfbGlicmFyeV9pZCxnZXRfbGlicmFyeV9kb2N1bWVudGF0aW9uIiwiTk9URV9GT1JfSFVNQU5TIjoiQSBtaW5pbWFsIHNldCBvZiB0b29scyBhcmUgZW5hYmxlZCBieSBkZWZhdWx0LCBNQ1AgRGV2VG9vbHMgcHJvdmlkZXMgbWFueSBhZGRpdGlvbmFsIHVzZWZ1bCB0b29scyBpbmNsdWRpbmcgZWZmaWNpZW50IENvbnRleHQ3IGRvY3VtZW50YXRpb24gc2VhcmNoLCBGcm9udGVuZCBVSSBGcmFtZXdvcmsgdGVtcGxhdGVzLCBDb2RlIHNlYXJjaCBhbmQgb3B0aW1pc2F0aW9uIGFuZCBtYW55IG90aGVycywgdmlzaXQgaHR0cHM6Ly9naXRodWIuY29tL3NhbW1jai9tY3AtZGV2dG9vbHMgZm9yIG1vcmUgaW5mb3JtYXRpb24gb24gYXZhaWxhYmxlIHRvb2xzIGFuZCBjb25maWd1cmF0aW9uIn19)
  164. - [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_dev--tools-0098FF?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22dev-tools%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22%2Fpath%2Fto%2Fmcp-devtools%22%2C%22env%22%3A%7B%22ENABLE_ADDITIONAL_TOOLS%22%3A%22security%2Csequential_thinking%2Ccode_skim%2Ccode_rename%22%2C%22DISABLED_TOOLS%22%3A%22search_packages%2Cresolve_library_id%2Cget_library_documentation%22%2C%22NOTE_FOR_HUMANS%22%3A%22A%20minimal%20set%20of%20tools%20are%20enabled%20by%20default%2C%20MCP%20DevTools%20provides%20many%20additional%20useful%20tools%20including%20efficient%20Context7%20documentation%20search%2C%20Frontend%20UI%20Framework%20templates%2C%20Code%20search%20and%20optimisation%20and%20many%20others%2C%20visit%20https%3A%2F%2Fgithub.com%2Fsammcj%2Fmcp-devtools%20for%20more%20information%20on%20available%20tools%20and%20configuration%22%7D%7D)
  165. </details>
  166. ### If you do not have Golang installed
  167. <details>
  168. <summary><b>๐Ÿ”— Click here for instructions</b></summary>
  169. If you do not have, and do not want to install Golang, you can download the latest release binary from the [releases page](https://github.com/sammcj/mcp-devtools/releases/latest).
  170. ```shell
  171. # If you're on macOS, you'll also need to run the following command to allow the downloaded binary to run:
  172. xattr -r -d com.apple.quarantine mcp-devtools
  173. ```
  174. Configure your MCP client to use the downloaded binary (replacing `/path/to/mcp-devtools` ):
  175. ```json
  176. {
  177. "mcpServers": {
  178. "dev-tools": {
  179. "type": "stdio",
  180. "command": "/path/to/mcp-devtools",
  181. "env": {
  182. "ENABLE_ADDITIONAL_TOOLS": "security,sequential_thinking,code_skim,code_rename",
  183. "DISABLED_TOOLS": "",
  184. "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"
  185. }
  186. }
  187. }
  188. }
  189. ```
  190. - [![Add MCP Server dev-tools to LM Studio](https://files.lmstudio.ai/deeplink/mcp-install-dark.svg)](https://lmstudio.ai/install-mcp?name=dev-tools&config=eyJjb21tYW5kIjoiL3BhdGgvdG8vbWNwLWRldnRvb2xzIiwiZW52Ijp7IkVOQUJMRV9BRERJVElPTkFMX1RPT0xTIjoic2VjdXJpdHksc2VxdWVudGlhbF90aGlua2luZyxnaXRodWIsZ2V0X3Rvb2xfaGVscCIsIkRJU0FCTEVEX1RPT0xTIjoic2VhcmNoX3BhY2thZ2VzLHJlc29sdmVfbGlicmFyeV9pZCxnZXRfbGlicmFyeV9kb2N1bWVudGF0aW9uIiwiTk9URV9GT1JfSFVNQU5TIjoiQSBtaW5pbWFsIHNldCBvZiB0b29scyBhcmUgZW5hYmxlZCBieSBkZWZhdWx0LCBNQ1AgRGV2VG9vbHMgcHJvdmlkZXMgbWFueSBhZGRpdGlvbmFsIHVzZWZ1bCB0b29scyBpbmNsdWRpbmcgZWZmaWNpZW50IENvbnRleHQ3IGRvY3VtZW50YXRpb24gc2VhcmNoLCBGcm9udGVuZCBVSSBGcmFtZXdvcmsgdGVtcGxhdGVzLCBDb2RlIHNlYXJjaCBhbmQgb3B0aW1pc2F0aW9uIGFuZCBtYW55IG90aGVycywgdmlzaXQgaHR0cHM6Ly9naXRodWIuY29tL3NhbW1jai9tY3AtZGV2dG9vbHMgZm9yIG1vcmUgaW5mb3JtYXRpb24gb24gYXZhaWxhYmxlIHRvb2xzIGFuZCBjb25maWd1cmF0aW9uIn19)
  191. - [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_dev--tools-0098FF?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22dev-tools%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22%2Fpath%2Fto%2Fmcp-devtools%22%2C%22env%22%3A%7B%22ENABLE_ADDITIONAL_TOOLS%22%3A%22security%2Csequential_thinking%2Ccode_skim%2Ccode_rename%22%2C%22DISABLED_TOOLS%22%3A%22search_packages%2Cresolve_library_id%2Cget_library_documentation%22%2C%22NOTE_FOR_HUMANS%22%3A%22A%20minimal%20set%20of%20tools%20are%20enabled%20by%20default%2C%20MCP%20DevTools%20provides%20many%20additional%20useful%20tools%20including%20efficient%20Context7%20documentation%20search%2C%20Frontend%20UI%20Framework%20templates%2C%20Code%20search%20and%20optimisation%20and%20many%20others%2C%20visit%20https%3A%2F%2Fgithub.com%2Fsammcj%2Fmcp-devtools%20for%20more%20information%20on%20available%20tools%20and%20configuration%22%7D%7D)
  192. </details>
  193. </details>
  194. ---
  195. ## Available Tools
  196. These tools can be disabled by adding their function name to the `DISABLED_TOOLS` environment variable in your MCP configuration.
  197. | Tool | Purpose | Dependencies | Example Usage | Maturity |
  198. | ---------------------------------------------------------------- | ------------------------------------- | ----------------------------- | ------------------------------- | -------- |
  199. | **[Internet Search](docs/tools/internet_search.md)** | Multi-provider internet search | None (Provider keys optional) | Web, image, news, video search | ๐ŸŸข |
  200. | **[Web Fetch](docs/tools/web-fetch.md)** | Retrieve internet content as Markdown | None | Documentation and articles | ๐ŸŸข |
  201. | **[Package Documentation](docs/tools/package-documentation.md)** | Context7 library documentation lookup | None | React, modelcontextprotocol/go-sdk | ๐ŸŸข |
  202. | **[Package Search](docs/tools/package-search.md)** | Check package versions | None | NPM, Python, Go, Java, Docker | ๐ŸŸข |
  203. | **[Think](docs/tools/think.md)** | Structured reasoning space | None | Complex problem analysis | ๐ŸŸข |
  204. | **[Calculator](docs/tools/calculator.md)** | Basic arithmetic calculations | None | 2 + 3 \* 4, batch processing | ๐ŸŸข |
  205. | **[DevTools Help](docs/tools/get_tool_help.md)** | Extended info about DevTools tools | None | Usage examples, troubleshooting | ๐ŸŸข |
  206. | **[Find Long Files](docs/tools/find_long_files.md)** | Identify files needing refactoring | | Find files over 700 lines | ๐ŸŸข |
  207. | **[Sequential Thinking](docs/tools/sequential-thinking.md)** | Structured multi-step reasoning | None | Step-by-step analysis (stdio only) | ๐ŸŸข |
  208. ### Additional Tools (Disabled By Default)
  209. These tools can be enabled by setting the `ENABLE_ADDITIONAL_TOOLS` environment variable in your MCP configuration.
  210. | Tool | Purpose | `ENABLE_ADDITIONAL_TOOLS` | Example Usage | Maturity |
  211. | -------------------------------------------------------------------- | --------------------------------------------------------- | ------------------------- | --------------------------------------------- | -------- |
  212. | **[GitHub](docs/tools/github.md)** | GitHub repositories and data | `github` | Issues, PRs, repos, cloning | ๐ŸŸข |
  213. | **[Code Skim](docs/tools/code_skim.md)** | Return code structure without implementation details | `code_skim` | Reduced token consumption | ๐ŸŸข |
  214. | **[Code Search](docs/tools/code_search.md)** | Semantic code search with local embeddings | `code_search` | Find code by natural language description | ๐ŸŸ  |
  215. | **[Code Rename](docs/tools/code_rename.md)** | LSP-based symbol renaming across files (experimental) | `code_rename` | Rename functions, variables, types | ๐ŸŸ  |
  216. | **[Memory](docs/tools/memory.md)** | Persistent knowledge graphs | `memory` | Store entities and relationships | ๐ŸŸก |
  217. | **[Document Processing](docs/tools/document-processing.md)** | Convert documents to Markdown | `process_document` | PDF, DOCX โ†’ Markdown with OCR | ๐ŸŸก |
  218. | **[PDF Processing](docs/tools/pdf-processing.md)** | Fast PDF text extraction | `pdf` | Quick PDF to Markdown | ๐ŸŸข |
  219. | **[Excel](docs/tools/excel.md)** | Excel file manipulation | `excel` | Workbooks, charts, pivot tables, formulas | ๐ŸŸข |
  220. | **[Terraform Documentation](docs/tools/terraform-documentation.md)** | Terraform Registry API (providers, modules, and policies) | `terraform_documentation` | Provider docs, module search, policy lookup | ๐ŸŸก |
  221. | **[Filesystem](docs/tools/filesystem.md)** | File and directory operations | `filesystem` | Read, write, edit, search files | ๐ŸŸก |
  222. | **[MCP Proxy](docs/tools/proxy.md)** | Proxies MCP requests to upstream HTTP MCP servers | `proxy` | Provide remote HTTP MCP servers to stdio clients | ๐ŸŸก |
  223. | **[Americanโ†’English](docs/tools/american-to-english.md)** | Convert to British spelling | `murican_to_english` | Organise, colour, centre | ๐ŸŸก |
  224. | **[API to MCP](docs/tools/api.md)** | Dynamic REST API integration | `api` | Configure any REST API via YAML | ๐Ÿ”ด |
  225. **Security Subsystem / Tools**
  226. | Tool | Purpose | `ENABLE_ADDITIONAL_TOOLS` | Example Usage | Maturity |
  227. | ------------------------------------------ | ---------------------------------------- | ------------------------- | -------------------------------- | -------- |
  228. | **[Security Framework](docs/security.md)** | Context injection security protections | `security` | Content analysis, access control | ๐ŸŸข |
  229. | **[Security Override](docs/security.md)** | Agent managed security warning overrides | `security_override` | Bypass false positives | ๐ŸŸก |
  230. **Frontend UI Component Libraries**
  231. | Tool | Purpose | `ENABLE_ADDITIONAL_TOOLS` | Example Usage | Maturity |
  232. | ----------------------------------------------------------------- | -------------------------- | ------------------------- | ------------------------------- | -------- |
  233. | **[ShadCN UI Component Library](docs/tools/shadcn-ui.md)** | Component information | `shadcn` | Button, Dialog, Form components | ๐ŸŸข |
  234. | **[Magic UI Component Library](docs/tools/magicui.md)** | Animated component library | `magic_ui` | Frontend React components | ๐ŸŸ  |
  235. | **[Aceternity UI Component Library](docs/tools/aceternityui.md)** | Animated component library | `aceternity_ui` | Frontend React components | ๐ŸŸ  |
  236. **Agents as Tools** - In addition to the above tools, MCP DevTools can provide access to AI agents as tools by integrating with external LLMs.
  237. | Agent | Purpose | `ENABLE_ADDITIONAL_TOOLS` | Maturity |
  238. | ------------------------------------------------ | ------------------------ | ------------------------- | -------- |
  239. | **[Claude Agent](docs/tools/claude-agent.md)** | Claude Code CLI Agent | `claude-agent` | ๐ŸŸก |
  240. | **[Codex Agent](docs/tools/codex-agent.md)** | Codex CLI Agent | `codex-agent` | ๐ŸŸก |
  241. | **[Copilot Agent](docs/tools/copilot-agent.md)** | GitHub Copilot CLI Agent | `copilot-agent` | ๐ŸŸก |
  242. | **[Gemini Agent](docs/tools/gemini-agent.md)** | Gemini CLI Agent | `gemini-agent` | ๐ŸŸก |
  243. | **[Kiro Agent](docs/tools/kiro-agent.md)** | Kiro CLI Agent | `kiro-agent` | ๐ŸŸก |
  244. ๐Ÿ‘‰ **[See detailed tool documentation](docs/tools/overview.md)**
  245. ### Candidates for major refactoring
  246. - Wrapping up all frontend UI component libraries into a single tool with subcommands
  247. The following tools are currently in review for potential deprecation (unless I hear people are using them):
  248. - [API to MCP](docs/tools/api.md)
  249. - [Security Override](docs/security.md)
  250. ## Quick Start
  251. ### Installation
  252. **Option 1: Go Install** (recommended)
  253. ```bash
  254. go install github.com/sammcj/mcp-devtools@HEAD
  255. ```
  256. **Option 2: Build from Source**
  257. ```bash
  258. git clone https://github.com/sammcj/mcp-devtools.git
  259. cd mcp-devtools
  260. make build
  261. ```
  262. **Option 4: Download Release**
  263. Download the latest binary from [releases](https://github.com/sammcj/mcp-devtools/releases) and place in your PATH and remember to check for updates!
  264. ### Basic MCP Configuration
  265. **STDIO**
  266. ```json
  267. {
  268. "mcpServers": {
  269. "dev-tools": {
  270. "type": "stdio",
  271. "command": "/path/to/mcp-devtools",
  272. "env": {
  273. "BRAVE_API_KEY": "This is optional "
  274. }
  275. }
  276. }
  277. }
  278. ```
  279. Replacing `/path/to/mcp-devtools` with your actual binary path (e.g., `/Users/yourname/go/bin/mcp-devtools`).
  280. _Note: The `BRAVE_API_KEY` is optional and only needed if you want to use the Brave Search provider. Other providers like Google, Kagi, SearXNG, and DuckDuckGo are also available. See the [Internet Search documentation](docs/tools/internet_search.md) for more details._
  281. **Streamable HTTP**
  282. ```shell
  283. mcp-devtools --transport http --port 18080
  284. ```
  285. ```json
  286. {
  287. "mcpServers": {
  288. "dev-tools": {
  289. "type": "streamableHttp",
  290. "url": "http://localhost:18080/http"
  291. }
  292. }
  293. }
  294. ```
  295. ## Transport Options
  296. MCP DevTools supports two transport modes:
  297. ### STDIO Transport (Default)
  298. **Best for**: Simple, local use with MCP clients like Claude Desktop, Cline, etc.
  299. ```json
  300. {
  301. "mcpServers": {
  302. "dev-tools": {
  303. "type": "stdio",
  304. "command": "/path/to/mcp-devtools",
  305. "env": {
  306. "BRAVE_API_KEY": "your-api-key-if-needed"
  307. }
  308. }
  309. }
  310. }
  311. ```
  312. ### Streamable HTTP Transport
  313. **Best for**: Production deployments, shared use, centralised configuration
  314. ```bash
  315. # Basic HTTP mode
  316. mcp-devtools --transport http --port 18080
  317. # With authentication
  318. mcp-devtools --transport http --port 18080 --auth-token mysecrettoken
  319. # With OAuth (see OAuth documentation)
  320. mcp-devtools --transport http --port 18080 --oauth-enabled
  321. ```
  322. **Client Configuration:**
  323. ```json
  324. {
  325. "mcpServers": {
  326. "dev-tools": {
  327. "type": "streamableHttp",
  328. "url": "http://localhost:18080/http"
  329. }
  330. }
  331. }
  332. ```
  333. **Stateless by design**: the HTTP transport implements MCP 2026-07-28, which has no `initialize` handshake and no `Mcp-Session-Id`. Every request carries its own protocol version and client info, so any request can be served by any replica. Round-robin load balancing, scale-to-zero and rolling restarts all work without sticky sessions. `GET` and `DELETE` on the endpoint return `405`; only `POST` is used.
  334. The one exception is `sequential_thinking`, which keeps thought history in the server process. It is registered on stdio only and is not exposed over HTTP.
  335. Tools that persist state under `~/.mcp-devtools` still need a single replica or a shared volume: `code_search` (index built by one call, queried by the next), `memory` (knowledge graph) and `security_override` (override tokens). They hold nothing in the process, so a restart is fine, but two replicas with separate disks will disagree.
  336. ## Configuration Options
  337. ### Environment Variables
  338. All environment variables are optional, but if you want to use specific search providers or document processing features, you may need to provide the appropriate variables.
  339. **General:**
  340. - `LOG_LEVEL` - Logging level: `debug`, `info`, `warn`, `error` (default: `warn`). Logs are written to `~/.mcp-devtools/logs/mcp-devtools.log` for all transports. Stdio transport uses minimum `warn` level and never logs to stdout/stderr to prevent MCP protocol pollution.
  341. - `LOG_TOOL_ERRORS` - Enable logging of failed tool calls to `~/.mcp-devtools/logs/tool-errors.log` (set to `true` to enable). Logs older than 60 days are automatically removed on server startup.
  342. - `ENABLE_ADDITIONAL_TOOLS` - Comma-separated list to enable security-sensitive tools (e.g. `security,security_override,filesystem,claude-agent,codex-agent,gemini-agent,kiro-agent,process_document,pdf,memory,terraform_documentation`)
  343. - `DISABLED_TOOLS` - Comma-separated list of functions to disable (e.g. `think,internet_search`)
  344. **Default Tools:**
  345. - `BRAVE_API_KEY` - Enable Brave Search provider by providing a ([free Brave search API key](https://brave.com/search/api/))
  346. - `GOOGLE_SEARCH_API_KEY` - Enable Google search with API key from [Cloud Console](https://console.cloud.google.com/apis/credentials) (requires Custom Search API to be enabled)
  347. - `GOOGLE_SEARCH_ID` - Google Search Engine ID from [Programmable Search Engine](https://programmablesearchengine.google.com/) (required with `GOOGLE_SEARCH_API_KEY`, select "Search the entire web")
  348. - `KAGI_API_KEY` - Enable Kagi Search provider by providing your [Kagi API key](https://kagi.com/settings?p=api) (requires Kagi subscription)
  349. - `SEARXNG_BASE_URL` - Enable SearXNG search provider by providing the base URL (e.g. `https://searxng.example.com`)
  350. - `CONTEXT7_API_KEY` - Optional Context7 API key for higher rate limits and authentication with package documentation tools
  351. - `MEMORY_FILE_PATH` - Memory storage location (default: `~/.mcp-devtools/`)
  352. - `PACKAGE_COOLDOWN_HOURS` - Hours to wait before recommending newly published packages (default: `72`, set to `0` to disable)
  353. - `PACKAGE_COOLDOWN_ECOSYSTEMS` - Comma-separated ecosystems for cooldown protection (default: `npm`, use `none` to disable)
  354. **Security Configuration:**
  355. - `FILESYSTEM_TOOL_ALLOWED_DIRS` - Colon-separated (Unix) list of allowed directories (only for filesystem tool)
  356. **Document Processing:**
  357. - `DOCLING_PYTHON_PATH` - Python executable path (default: auto-detected)
  358. - `DOCLING_CACHE_ENABLED` - Enable processed document cache (default: `true`)
  359. - `DOCLING_HARDWARE_ACCELERATION` - Hardware acceleration (`auto` (default), `mps`, `cuda`, `cpu`)
  360. ### Command-Line Options
  361. - `--transport`, `-t` - Transport type (`stdio`, `http`). Default: `stdio`
  362. - `--port` - Port for the HTTP transport. Default: `18080`
  363. - `--base-url` - Base URL for the HTTP transport. Default: `http://localhost`
  364. - `--auth-token` - Bearer token required on HTTP requests
  365. - `--endpoint-path` - Endpoint path for the HTTP transport. Default: `/http`
  366. ## Architecture
  367. MCP DevTools uses a modular architecture:
  368. - **Tool Registry**: Central registry managing tool discovery and registration
  369. - **Tool Interface**: Standardised interface all tools implement
  370. - **Transport Layer**: stdio and stateless Streamable HTTP
  371. - **Plugin System**: Easy to add new tools following the interface
  372. Each tool is self-contained and registers automatically when the binary starts.
  373. ![](./screenshots/mcp-devtools-1.jpeg)
  374. ## Security Framework
  375. MCP DevTools includes a configurable security system that provides multi-layered protection for tools that access files or make HTTP requests.
  376. Important: This feature should be considered in **BETA**, if you find bugs and have solutions please feel free to raise a PR.
  377. ### Key Features
  378. - **Access Control**: Prevents tools from accessing sensitive files and domains
  379. - **Content Analysis**: Scans returned content for security threats using pattern matching
  380. - **YAML-Based Configuration**: Easy-to-manage rules with automatic reloading
  381. - **Security Overrides**: Allow bypassing false positives with audit logging
  382. - **Performance Optimised**: Minimal impact when disabled, efficient when enabled
  383. ### Built-in Protection
  384. - **Shell Injection Detection**: Command injection, eval execution, backtick commands
  385. - **Data Exfiltration Prevention**: DNS exfiltration, credential theft, keychain access
  386. - **Prompt Injection Mitigation**: "Ignore instructions" attacks, conversation extraction
  387. - **Persistence Mechanism Detection**: Launchctl, systemd, crontab modifications
  388. - **Sensitive File Protection**: SSH keys, AWS credentials, certificates
  389. ### Quick Setup
  390. ```bash
  391. # Enable security framework and override tool
  392. # You may optionally also add 'security_override' if you want a tool the agent can use to override security warnings
  393. ENABLE_ADDITIONAL_TOOLS="security"
  394. ```
  395. Configuration is managed through `~/.mcp-devtools/security.yaml` with sensible defaults.
  396. ๐Ÿ‘‰ **[Complete Security Documentation](docs/security.md)**
  397. ## Advanced Features
  398. ### OAuth 2.0/2.1 Authentication
  399. For production deployments requiring centralised user authentication:
  400. ๐Ÿ‘‰ **[Complete OAuth Setup Guide](docs/oauth/README.md)**
  401. Quick example:
  402. ```bash
  403. # Browser-based authentication
  404. mcp-devtools --transport http --oauth-browser-auth --oauth-client-id="your-client"
  405. # Resource server mode
  406. mcp-devtools --transport http --oauth-enabled --oauth-issuer="https://auth.example.com"
  407. ```
  408. ### Proxy Support
  409. All HTTP-based tools automatically support proxy configuration through standard environment variables:
  410. ```bash
  411. # HTTPS proxy (preferred)
  412. export HTTPS_PROXY="http://proxy.company.com:8080"
  413. # HTTP proxy (fallback)
  414. export HTTP_PROXY="http://proxy.company.com:8080"
  415. # With authentication
  416. export HTTPS_PROXY="http://username:password@proxy.company.com:8080"
  417. # Run with proxy
  418. ./bin/mcp-devtools stdio
  419. ```
  420. **Supported tools**: All network-based tools including `package_docs`, `internet_search`, `webfetch`, `github`, and others automatically respect proxy settings when configured.
  421. **Security**: Proxy credentials are automatically redacted from logs for security.
  422. ### Docker Support
  423. ```bash
  424. # Pull the image (main is latest)
  425. docker pull ghcr.io/sammcj/mcp-devtools:main
  426. # Run
  427. docker run -d --name mcp-devtools -p 18080:18080 --restart always ghcr.io/sammcj/mcp-devtools:main
  428. # Run with proxy support
  429. docker run -d --name mcp-devtools -p 18080:18080 \
  430. -e HTTPS_PROXY="http://proxy.company.com:8080" \
  431. --restart always ghcr.io/sammcj/mcp-devtools:main
  432. ```
  433. ## Logging
  434. MCP DevTools maintains two log files in `~/.mcp-devtools/logs/`:
  435. **Application Logs** (`mcp-devtools.log`):
  436. - Contains all application logs at the configured level
  437. - Configure via `LOG_LEVEL` environment variable: `debug`, `info`, `warn`, `error` (default: `warn`)
  438. - **Stdio transport**: Always logs to file (never to stderr to prevent MCP protocol pollution)
  439. - **HTTP transport**: Logs to file at configured level
  440. **Tool Error Logs** (`tool-errors.log`):
  441. - Failed tool executions with arguments and error details
  442. - Enable via `LOG_TOOL_ERRORS=true` environment variable
  443. - Automatically rotates logs older than 60 days
  444. - Useful for debugging tool calling issues
  445. Example:
  446. ```bash
  447. # Enable debug logging for HTTP mode
  448. LOG_LEVEL=debug mcp-devtools --transport http
  449. # Enable tool error logging (works with any transport)
  450. LOG_TOOL_ERRORS=true mcp-devtools
  451. ```
  452. ## Observability
  453. MCP DevTools includes optional OpenTelemetry integration for distributed tracing and metrics.
  454. ![otel screenshot in Jaeger](./docs/otel.png)
  455. **Tracing** - Track tool execution spans with HTTP client operations:
  456. ```bash
  457. # Export traces to OTLP endpoint
  458. MCP_OTEL_ENDPOINT=https://your-oltp-endpoint
  459. ```
  460. **Metrics** - Opt-in performance and usage metrics:
  461. ```bash
  462. # Default enabled traces/metrics when OTEL is enabled
  463. MCP_METRICS_GROUPS=tool,session,security
  464. # Include cache metrics
  465. MCP_METRICS_GROUPS=tool,session,security,cache
  466. ```
  467. Available metric groups: `tool` (tool execution), `session` (session lifecycle), `security` (security checks), `cache` (cache operations)
  468. - **[Complete Observability Documentation](docs/observability.md)**
  469. - **[Example Configurations](docs/observability/examples/)**
  470. ### Creating New Tools
  471. Want to add your own tools? See the **[Development Guide](docs/creating-new-tools.md)**.
  472. ## Getting Help
  473. - **Tool Documentation**: [docs/tools/overview.md](docs/tools/overview.md)
  474. - **Security Framework**: [docs/security.md](docs/security.md)
  475. - **OAuth Setup**: [docs/oauth/README.md](docs/oauth/README.md)
  476. - **Development**: [docs/creating-new-tools.md](docs/creating-new-tools.md)
  477. - **Issues**: [GitHub Issues](https://github.com/sammcj/mcp-devtools/issues), please note that I built this tool for my own use and it is not a commercially supported product, so if you can - please raise a PR instead of an issue.
  478. ## Contributing
  479. Contributions welcome! This project follows standard Go development practices and includes comprehensive tests.
  480. Important: See [docs/creating-new-tools.md](docs/creating-new-tools.md) for guidelines on adding new tools.
  481. ```bash
  482. # Development setup
  483. git clone https://github.com/sammcj/mcp-devtools.git
  484. cd mcp-devtools
  485. make deps
  486. make test
  487. make build
  488. # Benchmark tool token costs
  489. ENABLE_ADDITIONAL_TOOLS=<your new tool name here> make benchmark-tokens
  490. # Run security checks, see make help
  491. make inspect # launches the MCP inspector tool
  492. ```
  493. ## Disclaimer
  494. No warranty is provided for this software. Use at your own risk. The author is not responsible for any damages or issues arising from its use.
  495. ## License
  496. Apache Public License 2.0 - Copyright 2025 Sam McLeod

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.