high-performance-mcp-server
This server currently exposes two basic MCP tools (echo and ping) under the default safe profile.
echo: Send a message and receive the exact same message back.
ping: Verify that the MCP server is responsive and reachable.
Additional filesystem, network, diagnostics, and workspace capabilities exist in the project but are only available when explicitly enabled via non-default profiles such as workspace, network, admin, or all.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@high-performance-mcp-serverFind TODO comments in the workspace"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
High-Performance MCP Server
A high-performance, modular Model Context Protocol (MCP) server built with TypeScript and the modern MCP v2 SDK (@modelcontextprotocol/server). Features safe-by-default security profiles, profile-aware server instructions, modular MCP prompts, allowlisted workspace inspection with opt-in guarded text mutation, SSRF-hardened network access, Streamable HTTP, Stdio transport, reusable worker thread pooling, production LRU caching with single-flight stampede protection, and structured telemetry.
Project Status: Public Preview (v0.4.0)
Status: 0.4.0 Public Preview.
This package provides safe-by-default MCP tools, read-only workspace inspection, opt-in guarded workspace mutation and network access, worker request cancellation, normalized progress reporting, and high-performance worker execution. Requires Node.js >= 22.0.0.
Related MCP server: VSCode LSP MCP Server
Features
Modern MCP v2 Architecture: Built natively on
@modelcontextprotocol/serverwith standard JSON Schema draft 2020-12 validation and full 2026-07-28 protocol support.Dual Transport Support: Run seamlessly over standard input/output (
stdio) or modern Streamable HTTP (node:http+/mcp).Profile-Aware Server Instructions: Dynamic server instructions that guide connected LLMs on recommended workflows, tool sequencing, and safety boundaries based on the active profile.
Modular MCP Prompts: Reusable task prompts (
explore_workspace,find_and_explain,review_file,trace_symbol) exposed exclusively inworkspace,workspace_write, andallprofiles.MCP-Native Workspace Completions: Autocompletes logical
rootIdvalues for every workspace prompt and the workspace resource template without enumerating files or exposing host paths.Safe-by-Default Tool Profiles: Default
safeprofile exposes zero filesystem, network, or hardware inspection. Filesystem mutation and outbound network access require explicitworkspace_write/network(orall) opt-in.Workspace Security & Host Path Privacy: Secure allowlisted directory access with path traversal and symlink escape prevention, logical root mapping (
root-1,root-2), bounded text operations, and binary file protection without exposing host absolute paths to clients or models. Theworkspaceprofile remains read-only; guarded mutation is isolated toworkspace_writeandall.Workspace Search v1: Fast, bounded literal file and text search (
search_files,search_text) with ignored directory defaults, bounded concurrency (SEARCH_CONCURRENCY = 8), coordinate mapping, and client cancellation.Worker Thread Pool with Cancellation: Offload CPU-heavy tasks from the Node.js event loop with automatic lifecycle recovery,
AbortSignalcancellation support, and prompt hard termination for running synchronous compute.Normalized MCP Progress Reporting: High-performance progress notifications across workspace search and compute worker tools with guaranteed in-order delivery and zero overhead when omitted.
Production LRU Cache: Memory-bounded cache with TTL support and single-flight request coalescing to eliminate cache stampedes.
Internal Structured Logging: Stdio-safe JSON logging exclusively on
stderr.
Quick Start
MCP Client Configuration (Claude Desktop, Cursor, etc.)
Add to your MCP configuration (e.g. claude_desktop_config.json):
Default Safe Profile (Stdio)
{
"mcpServers": {
"high-performance-mcp": {
"command": "npx",
"args": [
"-y",
"high-performance-mcp-server"
]
}
}
}Read-Only Workspace Profile
{
"mcpServers": {
"workspace-mcp": {
"command": "npx",
"args": [
"-y",
"high-performance-mcp-server",
"--profile=workspace",
"--root=/path/to/project"
]
}
}
}Local Development / Source Execution
# Clone and build
git clone https://github.com/AnIayana/high-performance-mcp-server.git
cd high-performance-mcp-server
npm install
npm run build
# Run default safe profile
node dist/index.js
# Run workspace profile with allowlisted root
node dist/index.js --profile=workspace --root=.Safe-by-Default Profiles
To protect host machines and prevent unintended resource consumption or metadata leakage, tools, resources, instructions, and prompts are categorized into security profiles:
Profile | Included Categories | Exposed Tools | Prompts | Use Case |
|
|
| (none) | Zero host inspection, zero filesystem access, zero mutation. Safe for public exposure. |
|
|
|
| Read-only file and directory inspection strictly limited to allowlisted |
|
|
|
| Guarded workspace text file creation, overwriting, and transactional editing with optimistic concurrency. |
|
|
| (none) | SSRF-hardened, read-only HTTP/HTTPS web fetching for public resources. |
|
|
| (none) | Process and system observability for monitoring health and event-loop lag. |
|
|
| (none) | CPU-intensive prime calculation benchmarks and worker pool tests. |
|
|
| (none) | Observability with administrative runtime state mutation (purging cache, resetting metrics). |
|
| All 20 registered tools | All 4 workspace prompts | Complete tool and prompt catalog. |
Server Instructions & Prompts
Profile-Aware Server Instructions
When an MCP client connects, the server delivers concise, profile-tailored instructions via the MCP protocol:
safe: Instructs the model that filesystem and hardware inspection are not available.workspace: Outlines the recommended investigation sequence (workspace_roots->search_files/search_text->file_info->read_text_file), reinforces read-only constraints, and emphasizes root-relative path usage.diagnostics&benchmark: Guides observational metrics interpretation and warns against unnecessary CPU-intensive compute invocations.admin: Notes that mutation operations affect only process-local caches and telemetry state.
Modular MCP Prompts
When running in workspace, workspace_write, or all profile, the server exposes modular prompts that provide structured workflows for common engineering tasks:
Prompt | Arguments | Purpose |
|
| Guides the model through structured exploration of an allowlisted workspace root using search and file inspection. |
|
| Locates relevant code or configuration using literal text search and reads defining files to produce an explanation. |
|
| Formulates a structured, read-only review of a specified text file within the workspace. |
|
| Traces declarations, references, and usage sites of a symbol across the workspace. |
Prompt arguments are treated as bounded task data and escaped before being inserted into reusable MCP prompt templates. Prompts donot execute direct filesystem I/O themselves; actual file reading and searching is performed by the model using standard MCP tools and resources under strict root allowlist controls.
Workspace Root Completions
Workspace-capable profiles advertise MCP's completions capability. Clients can request completion/complete suggestions for the rootId argument on all four workspace prompts and for the rootId variable in workspace:///{rootId}/{+path}. Suggestions contain only configured logical IDs such as root-1; they never enumerate files or reveal root names and absolute host paths. Profiles without workspace authority do not advertise completion support.
Read-Only Workspace Access
Filesystem access is disabled by default. To enable read-only workspace access, explicitly specify --profile=workspace and at least one allowlisted --root directory. The broader all profile also includes these tools but additionally enables mutation, network, diagnostics, benchmark, and admin capabilities.
# POSIX / macOS / Linux
npx high-performance-mcp-server --profile=workspace --root=/home/user/my-project
# Windows
npx high-performance-mcp-server --profile=workspace --root="C:\Projects\app"
# Multiple roots
npx high-performance-mcp-server --profile=workspace --root=./packages/core --root=./packages/cliSecurity Guarantees & Constraints
Host Path Privacy: Configured absolute filesystem paths remain internal to the server. The
workspace_rootstool returns logical root identifiers (id: "root-1", `name: "my-project"), and workspace resource URIs use those identifiers rather than absolute host paths:{ "roots": [ { "id": "root-1", "name": "my-project" } ] }Strict Allowlist: Only explicitly passed
--rootdirectories can be accessed. Maximum 16 unique roots allowed (and max 64 raw paths before deduplication).Read-Only Profile: The standard
workspaceprofile exposes no mutation tools. Guarded text mutation is available only through the explicitworkspace_writeandallprofiles; no MCP tools expose deletion, arbitrary rename, directory creation, permission changes, or command execution.Traversal & Symlink Protection: Target paths are canonicalized using
fs.realpathand strictly verified to never escape root boundaries.Sanitized Errors: Error responses reference only logical root IDs, root names, and requested relative paths, ensuring internal directory structures are never leaked.
File Read Limits: Default text read limit is 256 KiB; hard upper limit is 1 MiB (
MAX_TEXT_READ_BYTES).Binary File Detection: Files containing NUL bytes (
\0) are rejected byread_text_fileto prevent context pollution.MCP Resources: Exposes the canonical
workspace:///{rootId}/{+path}(workspace_text_file) template. Discover logical roots withworkspace_roots;resources/listdoes not recursively enumerate files.
Searching the Workspace
The workspace profile provides bounded, read-only search tools:
search_files:Searches file and directory names using literal substring matching.
Filters by kind (
file,directory,all), case sensitivity, and start path.Skips common build/vendor directories (
.git,node_modules,.next,dist,build,target, etc.) by default. PassincludeIgnored: trueto search them.Never traverses into symlink/junction directories to prevent recursion cycles and escapes.
Streams native MCP progress notifications (
notifications/progress) when a clientprogressTokenis provided.
search_text:Searches UTF-8 text files using bounded literal matching with fixed concurrency (8 workers).
Returns 1-based line, column, and trimmed preview snippets (up to 300 characters).
Supports file extension filters (e.g.
extensions: [".ts", ".md"]orextensions: ["ts", "md"]).Automatically skips binary files (NUL bytes) and files larger than 1 MiB (
MAX_SEARCH_FILE_BYTES).Limits: Hard defaults (
maxResults: 100[max 500],maxFiles: 5000[max 50000],timeoutMs: 10000[max 30000]).Fully cancellable via client
AbortSignal.Streams native MCP progress notifications (
notifications/progress) when requested viaprogressToken. Zero progress overhead when unrequested.
Guarded Workspace Text Write & Edit (workspace_write)
Workspace mutation is disabled by default. The standard workspace profile remains strictly read-only. To enable guarded text write and transactional editing capabilities, explicitly select the workspace_write profile (or all) along with at least one allowlisted --root:
# Start server with workspace write capabilities
npx high-performance-mcp-server --profile=workspace_write --root=./project --workspace-max-write-bytes=2097152Mutation Tools
When running with--profile=all or --profile=workspace_write, connected clients and LLMs have guarded text write and edit capabilities within configured --root directories. The standard --profile=workspace remains strictly read-only.
write_text_file:Create Mode (
mode: "create"): Creates a new UTF-8 text file inside an allowlisted workspace root. Enforces atomic no-clobber semantics viafs.link(or equivalent no-clobber publishing); fails safely if the file already exists (already_exists) or if the parent directory does not exist (missing_parent). ProvidingexpectedSha256in create mode is forbidden.Overwrite Mode (
mode: "overwrite"): Strictly requiresexpectedSha256(64-character lowercase hex) matching the file's current SHA-256 hash. If the file was modified concurrently, throwscontent_conflictand aborts without touching the target file.Exclusive Temp & Atomic Replacement: Creates an exclusive temporary file (
.mcp-temp-<uuid>.tmp) in the target directory (O_CREAT | O_EXCL), flushes to disk (fsync), re-validates the target file type and hash, and atomically replaces the destination.
{ "name": "write_text_file", "arguments": { "rootId": "root-1", "path": "src/config.json", "mode": "overwrite", "content": "{\n \"version\": 2\n}\n", "expectedSha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" } }edit_text_file:Exact Literal Replacement: Performs targeted, sequential in-memory text replacements without regex or special token expansion (e.g.
$$,$1,$&,$\``,$'` are inserted verbatim).Non-Overlapping Occurrence Guarantees: Evaluates
expectedOccurrences(default: 1) using non-overlapping literal matching matching the exact replacement semantics.Transactional Execution: Applies all edits sequentially in memory. If any edit fails its
expectedOccurrencescheck or if the file hash mismatchesexpectedSha256, the operation aborts and the disk file remains 100% untouched.Strict UTF-8 & BOM Preservation: Non-UTF-8 binary files are rejected (
invalid_text_encoding). Existing UTF-8 BOM headers and CRLF line endings are preserved with byte-for-byte fidelity.
{ "name": "edit_text_file", "arguments": { "rootId": "root-1", "path": "src/index.ts", "expectedSha256": "4b227777d4dd1fc61c6f884f48641d02b4d121d3fd328cb08b5531fcacdabf8a", "edits": [ { "oldText": "const PORT = 3000;", "newText": "const PORT = 8080;", "expectedOccurrences": 1 } ] } }
Operator-Configurable Write Limits
Server operators can set strict hard caps on the maximum allowed write or edit payload size in bytes:
CLI flag:
--workspace-max-write-bytes=<bytes>(1 to 5,242,880 bytes / 5 MiB, default:1048576/ 1 MiB)Environment variable:
MCP_WORKSPACE_MAX_WRITE_BYTES=<bytes>
Metadata & Concurrency Considerations
Atomic Replacement Metadata: Atomic replacement creates a new filesystem entry, preserving POSIX permission bits (
0755,0644) where supported. Other OS-specific metadata (e.g. inode number, creation timestampctime, ACL inheritance) may not be portably preserved.Residual Concurrency Boundaries: Pre-replace revalidation minimizes TOCTOU race conditions against untrusted MCP callers. However, a hostile local OS process with equivalent filesystem privileges executing concurrent writes in the microseconds after final validation may still race path-based operations.
Optional Client-Mediated Write Confirmation (Unreleased)
Confirmation is off by default. Enable it for both mutation tools with the operator-only --workspace-write-confirmation flag, or MCP_WORKSPACE_WRITE_CONFIRMATION=true (true/1/false/0). The CLI flag enables confirmation even if the environment says false; tool arguments cannot disable it. No tools are added and profile access stays unchanged.
high-performance-mcp-server --profile=workspace_write --root=./project --workspace-write-confirmationThe server validates the target, then asks the client to show a form containing a confirm boolean. Only an accepted response with confirm: true proceeds. Decline, cancel, false, and malformed accepted content leave the file unchanged. No temporary file is created while approval is pending. The normal root, size, exact-edit, and SHA-256 checks still run after approval, including when a file changes during the prompt.
The prompt identifies the operation and canonical logical rootId/relative path; it does not display file content, expected hashes, root names, or absolute host paths. Control and bidirectional formatting characters are escaped. Targets over 4,096 characters are refused instead of silently truncated. Response keys include the proposed arguments and resolved logical target so a changed proposal asks again.
Connection | Confirmation enabled |
MCP | Native |
Legacy MCP, stdio | SDK compatibility shim uses |
Legacy MCP, stateless HTTP | Refused: no reverse-request channel for approval |
Client without form elicitation | Refused without a mutation |
With confirmation disabled, existing modern and legacy calls behave as before. Use a client that actually presents the form to a human: elicitation is a client-mediated safeguard, not authentication or a security boundary against a malicious client. The server cannot prove that a human approved a client-supplied response. Direct service-level embedding is also outside this MCP handler gate. For protocol details, see the official SDK input-required guide.
MCP Workspace Resources
In addition to workspace inspection tools, this server natively exposes allowlisted workspace text files as standard MCP Resources using the official URI Template:
workspace:///{rootId}/{+path}Canonical Resource URI Format
Workspace resources use a stable, portable URI scheme based on logical root IDs rather than host filesystem paths:
workspace:///root-1/README.mdworkspace:///root-1/src/index.tsworkspace:///root-2/docs/architecture.md
Host absolute paths (such as file:///C:/... or /home/...) are never exposed in resource URIs, titles, or error messages.
Resource Invariants & Security Guarantees
Profile Gated: Workspace resources are exposed exclusively in workspace-capable profiles (
workspace,workspace_write,all). In non-workspace profiles (safe,network,diagnostics,benchmark,admin), resource endpoints returnMethod not foundand zero workspace existence is advertised.Strict Read-Only: Resources are strictly read-only. Possessing a resource URI never grants mutation rights or filesystem write capabilities.
Root & Symlink Confinement: Resource reads reuse the central workspace security resolver, enforcing strict containment inside configured
--rootdirectories and blocking symlink/junction escapes.Complete-or-Error Semantics: Resources are never silently truncated. If a file exceeds the operator byte limit, the read is rejected with
resource_too_large.Strict UTF-8 & Text Only: All resource content is decoded strictly as UTF-8 text (
fatal: true). Files containing NUL bytes (0x00) or non-UTF-8 sequences are rejected as unsupported binary files (invalid_text_encoding).No Recursive Enumeration:
resources/templates/listadvertises the resource template (workspace_text_file). The server does not recursively crawl repository directories forresources/list, preventing latency, memory spikes, and information disclosure on large repositories.Operator-Configurable Resource Size Limits:
CLI flag:
--workspace-max-resource-bytes=<bytes>(1 to 5,242,880 bytes / 5 MiB, default:1048576/ 1 MiB)Environment variable:
MCP_WORKSPACE_MAX_RESOURCE_BYTES=<bytes>
Recommended Client Workflow
Discovery: Discover available root IDs and paths using
workspace_roots,list_directory, orsearch_files.Read Resource: Consume text files directly via standard MCP
resources/readusingworkspace:///<rootId>/<path>.Guarded Mutation: When mutations are needed, use
read_text_fileto obtain the authoritativesha256hash and perform concurrency-controlled edits viawrite_text_fileoredit_text_filein theworkspace_writeprofile.
Network Access & fetch_url
Network access is disabled by default. To enable SSRF-hardened read-only web fetching, run with --profile=network (or --profile=all):
# Start server with opt-in network profile
npx high-performance-mcp-server --profile=networkfetch_url Tool Details
The fetch_url tool performs a strictly bounded, read-only HTTP/HTTPS GET request to public web resources.
{
"name": "fetch_url",
"arguments": {
"url": "https://raw.githubusercontent.com/modelcontextprotocol/specification/main/LICENSE",
"maxBytes": 1048576,
"timeoutMs": 10000
}
}Security Guarantees & Constraints
Multi-Layered SSRF Defense: All resolved IP addresses are evaluated against standard IPv4/IPv6 private and special-use subnets (
net.BlockList). Loopback (127.0.0.0/8,::1), private RFC 1918 (10.0.0.0/8,172.16.0.0/12,192.168.0.0/16), link-local (169.254.0.0/16,fe80::/10), carrier-grade NAT (100.64.0.0/10), cloud metadata (169.254.169.254,metadata.google.internal), unique-local IPv6 (fc00::/7), multicast, and IPv4-mapped IPv6 (::ffff:x.x.x.x) destinations are strictly blocked.Authoritative Socket Lookup (DNS Rebinding Prevention): Connection sockets use a dedicated, security-aware lookup hook ensuring TCP sockets connect only to verified public IP addresses, eliminating time-of-check to time-of-use (TOCTOU) DNS rebinding.
Allowed Port Allowlist: Strictly limited to standard public web ports:
80,443,8080, and8443.Manual Redirect Re-validation: Up to 5 redirects (
301,302,303,307,308) are manually followed. Every intermediate target is re-validated against full URL, port, and IP security policies. HTTPS-to-HTTP downgrade redirects are rejected.Zero IP Disclosure: Error messages returned to clients never leak internal IP addresses, local socket details, or DNS topologies.
Bounded Resource Usage: Streaming response reader buffers only up to requested
maxBytes(default 1 MiB, hard maximum 5 MiB). If payload exceeds limit,truncated: trueis returned and the stream is immediately destroyed.Strict Textual Decoding: Decodes exclusively textual MIME types (
text/*,application/json,application/xml,application/javascript,application/xhtml+xml,application/yaml) with fatal UTF-8 decoding (new TextDecoder("utf-8", { fatal: true })). Binary bodies and explicit non-UTF-8 encodings are rejected.
Operator-Configurable Egress Policy
Server operators can enforce additional deployment-level egress policies to restrict outbound network capabilities:
Allowed Hostname Patterns (
--network-allow-host,MCP_NETWORK_ALLOW_HOSTS_JSON):Limits network egress exclusively to specified exact hostnames (
example.com) or subdomain wildcards (*.githubusercontent.com).Repeatable on CLI or specified as a JSON string array in environment variables.
If configured, any unlisted host is rejected with
host_not_allowed("Destination hostname is not allowed by server network policy.").
Denied Hostname Patterns (
--network-deny-host,MCP_NETWORK_DENY_HOSTS_JSON):Explicitly blocks specified hostnames or subdomain wildcards.
Deny takes strict precedence over allow: If a destination matches both allow and deny patterns, it is rejected with
host_denied("Destination hostname is denied by server network policy.").
HTTPS-Only Mode (
--network-https-only,MCP_NETWORK_HTTPS_ONLY):Enforces encrypted HTTPS for all outbound requests. Any
http://initial target or redirect destination is rejected withhttps_required("HTTPS is required by server network policy.").
Operator Resource Caps:
--network-max-response-bytes(MCP_NETWORK_MAX_RESPONSE_BYTES): Clamps the maximum response size (1 to 5,242,880 bytes).--network-max-timeout-ms(MCP_NETWORK_MAX_TIMEOUT_MS): Clamps the maximum request timeout (1,000 to 30,000 ms).
Operator Restrictions Are Subtractive Only: Operator configuration can never weaken or override built-in SSRF protections. Private IPs, loopback, link-local, carrier-grade NAT, and cloud metadata destinations remain strictly blocked even if listed in --network-allow-host.
Conditional HTTP Response Cache
An optional, bounded, in-memory conditional cache can be enabled for fetch_url to reduce upstream bandwidth and latency for frequently accessed public HTTPS documents:
Flag:
--network-cache(MCP_NETWORK_CACHE_ENABLED=true)Retention & Sizing Caps:
--network-cache-max-size-bytes=<n>(MCP_NETWORK_CACHE_MAX_SIZE_BYTES): Logical max cache payload size (1 KiB to 64 MiB, default 16 MiB).--network-cache-max-entries=<n>(MCP_NETWORK_CACHE_MAX_ENTRIES): Maximum cached entries (1 to 512, default 128).--network-cache-ttl-ms=<n>(MCP_NETWORK_CACHE_TTL_MS): Retention TTL in ms (1,000 to 3,600,000 ms, default 300,000 ms / 5 minutes).
Mandatory Revalidation Invariant: Cached entries are never served offline without revalidation. Every reuse sends conditional headers (
If-None-Match,If-Modified-Since) to the origin over the full secure network transport (SSRF checks, DNS rebinding lookup, operator policy, and timeout deadline).Zero Stale Fallback: If the origin is unreachable, times out, or changes to a private IP, the error is immediately returned; stale cached content is never served.
Privacy-Preserving Keys: Cache keys are opaque SHA-256 hashes of canonical HTTPS URLs. Plaintext URLs and authorization credentials are never stored.
Command Line Interface (CLI)
Usage:
high-performance-mcp-server [options]
Options:
--transport=<stdio|http> Transport protocol to run (default: stdio)
--port=<number> HTTP server port (default: 3000, only for http transport)
--profile=<profile> Security tool profile (default: safe)
--root=<path> Allowlisted workspace root (repeatable, max 16)
--workspace-max-write-bytes=<n> Operator hard cap for text write/edit size in bytes (1-5242880, default: 1048576)
--workspace-max-resource-bytes=<n> Operator hard cap for resource read size in bytes (1-5242880, default: 1048576)
--workspace-write-confirmation Require client-mediated confirmation before text write/edit operations
--network-allow-host=<pattern> Allowlisted public hostname or *.domain pattern (repeatable, operator restriction)
--network-deny-host=<pattern> Denylisted hostname or *.domain pattern (repeatable, operator restriction)
--network-https-only Enforce HTTPS-only mode for all network requests (operator restriction)
--network-max-response-bytes=<n> Operator hard cap for response size in bytes (1-5242880, default: 5242880)
--network-max-timeout-ms=<n> Operator hard cap for request timeout in ms (1000-30000, default: 30000)
--network-cache Enable conditional in-memory response cache for fetch_url (operator restriction)
--network-cache-max-size-bytes=<n> Logical max cache payload size in bytes (1024-67108864, default: 16777216)
--network-cache-max-entries=<n> Max cache entry count (1-512, default: 128)
--network-cache-ttl-ms=<n> Max cache retention TTL in ms (1000-3600000, default: 300000)
--list-tools Display available tools for the active profile and exit
--help, -h Show this help message and exit
--version, -v Show version and exitExamples
# Start default safe server on stdio
high-performance-mcp-server
# Start with network profile, operator egress restrictions, and conditional cache
high-performance-mcp-server --profile=network \
--network-allow-host=example.com \
--network-allow-host="*.githubusercontent.com" \
--network-https-only \
--network-max-response-bytes=262144 \
--network-max-timeout-ms=5000 \
--network-cache \
--network-cache-max-entries=256
# List tools available under the workspace profile
high-performance-mcp-server --profile=workspace --list-tools
# Run Streamable HTTP transport on port 8080 with workspace profile
high-performance-mcp-server --transport=http --port=8080 --profile=workspace --root=./projectHTTP Transport Details
When started with --transport=http, the server launches a Streamable HTTP transport using Node.js built-in node:http:
Endpoint:
http://127.0.0.1:<port>/mcpSecurity: The server binds strictly to
127.0.0.1and validatesHostandOriginheaders to protect against DNS rebinding and cross-site request forgery.Warning: Do not expose the HTTP transport directly to untrusted networks without an authenticating reverse proxy or gateway.
Environment Variables
Variable | Type | Default | Description |
|
|
| Default tool profile override ( |
|
|
| Default HTTP port override (strict integer 1-65535) |
|
| (none) | JSON array of workspace roots (e.g. |
|
|
| Require client-mediated write/edit approval ( |
|
| (none) | JSON array of allowed public host patterns (e.g. |
|
| (none) | JSON array of denied host patterns (e.g. |
|
|
| Enforce HTTPS-only mode for all network requests ( |
|
|
| Operator response byte cap override (1 to 5242880) |
|
|
| Operator request timeout cap in ms override (1000 to 30000) |
|
|
| Enable conditional in-memory response cache ( |
|
|
| Logical max cache payload size override in bytes (1024 to 67108864) |
|
|
| Max cache entries override (1 to 512) |
|
|
| Max cache retention TTL override in ms (1000 to 3600000) |
|
|
| Number of worker threads spawned in the pool (1 to 16) |
|
|
| Maximum entries in the LRU compute cache (1 to 10000) |
|
|
| LRU compute cache entry Time-to-Live in milliseconds (5 minutes) |
Development
# Install dependencies
npm install
# Run code generator and TypeScript typecheck
npm run typecheck
# Execute unit, security, search, and modern protocol integration test suites
npm test
# Build production bundle
npm run build
# Validate npm package payload without publishing
npm run pack:check
# Run package payload security & privacy scan
npm run security:package
# Run end-to-end tarball installation smoke test
npm run smoke:packageArchitecture
MCP Clients (Claude Desktop, Cursor, Custom SDK Clients)
│
┌───────────────┴───────────────┐
▼ ▼
Stdio Transport Streamable HTTP Transport
(process.stdin / stdout) (127.0.0.1:3000/mcp)
│ │
└───────────────┬───────────────┘
▼
McpServer Instance
(Profile-Aware Server Instructions)
│
┌───────────────┴───────────────┐
▼ ▼
Tool & Prompt Profiles Internal Telemetry
(safe, workspace, diag, ...) (Metrics & Stderr Logger)
│ │
├──────► Read-Only Workspace, Search, Resources & Prompts (Allowlisted Roots, Host Privacy)
│
├──────► In-Memory LRU Cache (Single-Flight Stampede Protection)
│
└──────► Reusable Worker Thread Pool (CPU Offloading)Security
Default security profile (
safe) ensures no filesystem or hardware inspection is exposed without explicit opt-in.Read-only workspace access strictly isolates file access to configured
--rootdirectories without revealing host filesystem absolute paths.Server instructions and prompts reinforce safe tool sequencing and explicit task boundaries with character escaping.
Stdio transport reserves
stdoutexclusively for JSON-RPC messages; all internal debug and telemetry logs route tostderr.HTTP transport enforces strict localhost origin and host header validation.
For details, review SECURITY.md.
Contributing & Releases
Contributions and feedback are welcome! Please read CONTRIBUTING.md for details on code style, tool development conventions, testing requirements, and the maintainer release workflow.
License
This project is licensed under the MIT License.
Available Tools
2 toolsechoEcho ToolA
Echoes back the provided message
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | The message to echo back |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full responsibility for behavioral disclosure. It accurately states that the tool returns the provided message, which is the only meaningful behavioral trait. No side effects, auth, or rate limits are relevant for this simple operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence that contains zero filler. Every word earns its place, and the structure is ideal for such a minimal tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's extreme simplicity—one parameter, no output schema, no annotations—the description fully covers the operation. There is nothing missing that an agent would need to select and invoke this tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and the 'message' parameter is already fully documented in the schema. The tool description adds no additional semantic value beyond the schema, meeting the baseline for high coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb 'Echoes' with a clear object 'the provided message', making the tool's function obvious. It distinguishes from sibling 'ping' by implication (echo vs. connectivity check), but does not explicitly differentiate.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The use case is implied by the simple definition—'if you need to echo a message, use this tool'—but there is no explicit when-to-use guidance or mention of the sibling tool 'ping'. For such a trivial tool, the implication is adequate but not stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
pingPingA
Checks whether the MCP server is responsive
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description does not explicitly mention side effects or whether the operation is read-only. However, the nature of a ping implies a non-destructive check, so it is somewhat transparent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that is easy to understand and directly conveys the purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description covers the primary purpose but does not specify the return value or output format, which might be ambiguous without a schema. It could be improved by indicating the type of response expected.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are no parameters, so the schema covers all aspects. No additional parameter explanation is needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's function as a server responsiveness check, distinguishing it from the sibling 'echo' tool which likely echoes input.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use it (for health checks), and the context of only one sibling ('echo') makes the usage scenario unambiguous, though it does not explicitly state alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
The two tools have entirely distinct purposes: echo returns a message, while ping checks server responsiveness. There is no overlap or ambiguity in their functionality.
Both tool names are single, lowercase verbs (echo, ping) that clearly describe their actions. The naming style is perfectly consistent and predictable.
With only 2 tools, the server is at the lower boundary of what feels minimal. While each tool serves a purpose, the set is extremely thin for a server named 'high-performance', which typically implies broader functionality.
The tool surface is almost nonexistent for a general-purpose server. While echo and ping are fully realized for their narrow functions, there are no operations that would support meaningful workflows, leaving significant gaps in coverage for any real domain.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
A MCP server built for developers enabling Git based project management with project and personal…
A simple Typescript MCP server built using the official MCP Typescript SDK and smithery/cli. This…
An MCP server for deep research or task groups
The official Svelte MCP server providing docs and autofixing tools for Svelte development
Related MCP Servers
- AlicenseBqualityDmaintenanceTypeScript-based MCP server designed to enhance code editing experiences by providing features such as hover information, code completion, and diagnostics.32026MIT
- AlicenseNot gradedqualityAmaintenanceAn MCP server that exposes Language Server Protocol features to external clients, allowing access to hover information, definitions, completions, references, and rename functionalities.1640MIT
- AlicenseAqualityDmaintenanceA lightweight MCP server that provides 40 tools for TypeScript/JavaScript refactoring and code intelligence, directly mapping to TypeScript's tsserver protocol commands for accurate structural changes and workspace analysis.40343MIT
- AlicenseNot gradedqualityCmaintenanceA TypeScript-based MCP server that enables code search, file reading, and project management via the GitLab API.251ISC
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/AnIayana/high-performance-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server