# High Performance MCP Server

> High Performance MCP Server is an open-source MCP server for developer tools. Local MCP v2 server with safe profiles, workspace search, guarded edits and workers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/aniayana/high-performance-mcp-server
- **MCP Registry name:** io.github.AnIayana/high-performance-mcp-server
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

Safety is the organising idea. By default the server exposes no filesystem, network or hardware tools at all; you opt in with profiles. The workspace profile adds read-only inspection of allowlisted roots, while workspace_write and network (or all) enable guarded edits and outbound fetches.

The workspace tools include search_files, search_text, list_directory (bounded recursion up to five levels, 500 entries), file_info, edit_text_file and write_text_file, with optimistic SHA-256 concurrency control and path traversal and symlink protections. Host paths are hidden behind logical roots such as root-1. fetch_url applies SSRF defences, DNS rebinding mitigation and a port allowlist. Prompts such as explore_workspace and trace_symbol appear only in workspace-capable profiles.

Under the hood it uses a worker thread pool with cancellation, an LRU cache with single-flight protection, structured stderr logging and progress reporting. It runs over stdio or loopback-only Streamable HTTP with a /healthz probe and an opt-in dashboard. Version 0.7.0 is a public preview and needs Node 22 or newer.

## Features

- **Profile-gated tools:** The default safe profile exposes no filesystem, network or hardware access.
- **Guarded workspace edits:** edit_text_file and write_text_file use SHA-256 concurrency checks and no-clobber creation.
- **Hardened fetch:** fetch_url has SSRF defences, DNS rebinding mitigation and a port allowlist.
- **Worker pool:** CPU-heavy work runs on worker threads with cancellation support.
- **LRU cache:** Memory-bounded cache with TTL and single-flight request coalescing.
- **Loopback HTTP:** Streamable HTTP binds to 127.0.0.1 with a /healthz endpoint and optional dashboard.

## Good for

- Give an agent read-only search over one project folder
- Allow guarded edits to a workspace with explicit opt-in
- Embed an MCP server in a Node.js application with operator policies
- Fetch web pages for an agent with SSRF protection
- Study a reference design for worker-pool MCP servers

## Install

### Claude Code (Terminal)

```sh
claude mcp add high-performance-mcp-server -- npx -y high-performance-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "high-performance-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "high-performance-mcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "high-performance-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "high-performance-mcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "high-performance-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "high-performance-mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "high-performance-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "high-performance-mcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "high-performance-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "high-performance-mcp-server"
      ]
    }
  }
}
```

## Tools

- `file_info`: Return file metadata, optionally with a SHA-256 hash.
- `search_files`: Find files by name with optional extension filters.
- `search_text`: Bounded literal text search with optional context lines.
- `list_directory`: List a directory, optionally recursing up to five levels.
- `edit_text_file`: Transactional text edit with concurrency control.
- `write_text_file`: Atomic no-clobber file creation.
- `fetch_url`: Fetch an HTTP or HTTPS URL with SSRF protections.

## FAQ

### What is exposed by default?

Nothing from the filesystem, network or hardware; the default safe profile is deliberately empty.

### How do I enable workspace tools?

Start with --profile=workspace and --root=/path/to/project.

### Which transports work?

stdio, and Streamable HTTP bound to loopback only.

### What Node version is needed?

Node.js 22 or newer.

### What is the status?

Version 0.7.0 is a public preview.

### Is High Performance MCP Server free?

Yes. High Performance MCP Server is open source, so you can use and self-host it for free.

### How do I add High Performance MCP Server to Claude Code?

Run this command in your terminal: claude mcp add high-performance-mcp-server -- npx -y high-performance-mcp-server

### What are the best alternatives to High Performance MCP Server?

The closest alternatives to High Performance MCP Server are Filesystem MCP, Local Workspace MCP, Coding Tools MCP, MCP Server Filesystem and NEPHIS MCP Server.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Filesystem MCP](https://ai-powered.com/mcp/filesystem-mcp): Filesystem MCP is a free MCP server for files and documents.
- [Local Workspace MCP](https://ai-powered.com/mcp/local-workspace-mcp): Local Workspace MCP is a free MCP server for developer tools.
- [Coding Tools MCP](https://ai-powered.com/mcp/coding-tools-mcp): Coding Tools MCP is an open-source MCP server for developer tools.
- [MCP Server Filesystem](https://ai-powered.com/mcp/mcp-server-filesystem): MCP Server Filesystem is an open-source MCP server for files and documents.
- [NEPHIS MCP Server](https://ai-powered.com/mcp/nephis-mcp-server): NEPHIS MCP Server is a freemium MCP server for developer tools.
- [McpMux](https://ai-powered.com/mcp/mcpmux): McpMux is an open-source MCP server for developer tools.
- [MCP Safe Actions](https://ai-powered.com/mcp/mcp-safe-actions): MCP Safe Actions is an open-source MCP server for developer tools.
- [Nx MCP](https://ai-powered.com/mcp/nx-mcp): Nx MCP is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/high-performance-mcp-server
