FieldCure.Mcp.Essentials 2.6.0

FieldCure.Mcp.Essentials

Install once, get the basics. An MCP server with 20 essential tools for any MCP client — web search with runtime engine switching (get/set), Wolfram|Alpha, web/document fetching, URL file downloads, shell, JavaScript sandbox, file I/O, and persistent memory. Category search (news, images, scholar, patents) is always available with per-tool runtime capability guards against the active engine.

Tools

Category Search (SerpApi / Serper / Tavily)

Always registered. Each tool runtime-guards on the active engine's capabilities and returns a descriptive error pointing at set_search_engine when the current engine does not support the category.

Document Parsing

web_fetch and read_file can parse binary documents into Markdown:

Output includes headings, tables, math expressions ([math: LaTeX]), and slide/page separators.

File Downloads

download_file saves the original bytes from an HTTP(S) URL. If save_path is omitted, the tool infers a filename from Content-Disposition, the URL path, or a generated fallback name. Relative save_path values resolve under the configured download_directory; absolute paths are used as-is except for protected system directories.

The default download directory is ~/Downloads/mcp and is created automatically on first use. Downloads are written to a temporary file in the destination directory and then committed with an atomic move/replace, so failed or cancelled downloads do not leave a partial final file.

Configure it in %LOCALAPPDATA%/FieldCure/Mcp.Essentials/settings.json:

{
  "download_directory": "~/Downloads/mcp"
}

Override with --download-directory <path> or ESSENTIALS_DOWNLOAD_DIRECTORY.

Web Search

Default engine is Bing (free, no API key needed). For more reliable results, use an API-based engine:

# Use Serper
fieldcure-mcp-essentials --search-engine serper --search-api-key YOUR_KEY

# Or via environment variables
ESSENTIALS_SEARCH_ENGINE=tavily ESSENTIALS_SEARCH_API_KEY=xxx fieldcure-mcp-essentials

Engine-specific environment variables are also auto-detected when --search-engine is omitted:

Use the region parameter for localized results:

{ "query": "서울 맛집", "region": "ko-kr" }

Without --search-engine, a fallback engine (Bing → DuckDuckGo) auto-switches on CAPTCHA.

If a paid engine is selected explicitly but no API key is configured, the server no longer silently falls back. On the first web_search call it asks the MCP client for the key via MCP Elicitation; if the client does not support Elicitation, or the user declines and then also declines the follow-up "use free fallback?" prompt, the call soft-fails with a clear message. Cached keys live for the process lifetime.

Wolfram|Alpha

wolfram_alpha calls the Full Results API v2 and returns mixed text/image content. MathML is passed through verbatim — clients that render MathML (e.g. ChatPanel WebView2) display formulas natively, no client-side conversion needed. Plots and other visual pods are embedded as ImageContent. The API's reinterpret=true flag is always on, so the server auto-corrects most failed queries before returning.

Set WOLFRAM_APPID to the AppID obtained at developer.wolframalpha.com (select Full Results API, free tier: 2,000 calls/month, non-commercial). Clients that support MCP Elicitation are prompted for the key on first use if the env var is unset.

⚠️ Use developer.wolframalpha.com, not developer.wolfram.com — the latter is a separate paid portal.

The tool is always registered regardless of AppID status; without a key it returns a setup-guidance error so the model can inform the user.

Run Command

run_command defaults to cmd.exe on Windows and /bin/sh on Unix for backward compatibility. Pass shell to opt into pwsh, powershell, cmd, bash, or sh. Responses include shell_used, stdout_truncated, and stderr_truncated; max_output_chars caps stdout and stderr independently.

Memory

Memories are stored in SQLite (%LOCALAPPDATA%/FieldCure/Mcp.Essentials/memory.db) and shared across all MCP clients on the same machine.

# Custom memory path
fieldcure-mcp-essentials --memory-path /path/to/memory.db

# Or via environment variable
ESSENTIALS_MEMORY_PATH=/path/to/memory.db fieldcure-mcp-essentials

Quick Start

dotnet tool install -g FieldCure.Mcp.Essentials

Claude Desktop

{
  "mcpServers": {
    "essentials": {
      "command": "fieldcure-mcp-essentials"
    }
  }
}

VS Code

{
  "servers": {
    "essentials": {
      "command": "fieldcure-mcp-essentials"
    }
  }
}

Requirements

• .NET 8.0 Runtime

Optional

Works out of the box with no additional dependencies. If available on your system, run_command can leverage tools like Node.js, Python, Git, Docker, and any other CLI tools.

See Also

Part of the AssistStudio ecosystem.

Links

• GitHub
• License: MIT