FieldCure.Mcp.Essentials
2.1.0
See the version list below for details.
dotnet tool install --global FieldCure.Mcp.Essentials --version 2.1.0
dotnet new tool-manifest
dotnet tool install --local FieldCure.Mcp.Essentials --version 2.1.0
#tool dotnet:?package=FieldCure.Mcp.Essentials&version=2.1.0
nuke :add-package FieldCure.Mcp.Essentials --version 2.1.0
FieldCure.Mcp.Essentials
Install once, get the basics. An MCP server with 12–16 essential tools for any MCP client — web search, web/document fetching, shell, JavaScript sandbox, file I/O, and persistent memory. With SerpApi or Serper, category search tools (news, images, scholar, patents) are auto-registered.
Tools
| Tool | Description |
|---|---|
http_request |
Full HTTP client (GET/POST/PUT/DELETE/PATCH/HEAD) with SSRF protection and max_response_chars for response size control |
web_search |
Search the web and return snippets (title, URL, description) |
web_fetch |
Fetch a URL and extract content as Markdown — HTML pages and documents (PDF, DOCX, HWPX, PPTX, XLSX) |
run_command |
Shell command execution with timeout, working directory, and env vars |
run_javascript |
Sandboxed JavaScript (Jint) — math, JSON, regex, data processing |
get_environment |
System info — time, timezone, OS, hostname, username |
read_file |
Read files — text with offset/limit, documents (PDF, DOCX, HWPX, PPTX, XLSX) parsed to Markdown |
write_file |
File writing (overwrite/append) with auto directory creation |
search_files |
File search by glob pattern and content (grep-like) |
remember |
Store a key-value memory (persisted in SQLite) |
forget |
Delete memories by key or keyword search |
list_memories |
Search and list stored memories with FTS5 and pagination |
Category Search (dynamic — SerpApi / Serper)
| Tool | Description | SerpApi | Serper | Tavily |
|---|---|---|---|---|
search_news |
Search recent news articles via Google News | Yes | Yes | Yes |
search_images |
Search images with size/type filtering | Yes | Yes | — |
search_scholar |
Search academic papers with citation counts | Yes | Yes | — |
search_patents |
Search patent documents with inventor/assignee filtering | Yes | Yes | — |
Document Parsing
web_fetch and read_file can parse binary documents into Markdown:
| Format | Extension | Detection |
|---|---|---|
.pdf |
Content-Type / URL extension (text-layer only; scanned pages yield empty text — use fieldcure-mcp-rag for OCR) |
|
| Word | .docx |
Content-Type / URL extension |
| Hangul (HWPX) | .hwpx |
URL extension (no standard Content-Type) |
| PowerPoint | .pptx |
Content-Type / URL extension |
| Excel | .xlsx |
Content-Type / URL extension |
Output includes headings, tables, math expressions ([math: LaTeX]), and slide/page separators.
Web Search
Default engine is Bing (free, no API key needed). For more reliable results, use an API-based engine:
| Engine | Free Tier | API Key |
|---|---|---|
| Bing (default) | Unlimited (scraping) | Not needed |
| Serper | 2,500 one-time | serper.dev |
| Tavily | 1,000/month | tavily.com |
| SerpApi | 100/month | serpapi.com |
# 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:
| Engine | Environment Variable |
|---|---|
| Serper | SERPER_API_KEY |
| SerpApi | SERPAPI_API_KEY |
| Tavily | TAVILY_API_KEY |
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.
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
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
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.6.0 | 108 | 4/29/2026 |
| 2.5.0 | 103 | 4/25/2026 |
| 2.4.0 | 101 | 4/23/2026 |
| 2.3.0 | 100 | 4/23/2026 |
| 2.2.0 | 107 | 4/22/2026 |
| 2.1.1 | 107 | 4/21/2026 |
| 2.1.0 | 110 | 4/20/2026 |
| 2.0.0 | 107 | 4/17/2026 |
| 1.5.0 | 101 | 4/14/2026 |
| 1.4.2 | 113 | 4/10/2026 |
| 1.4.1 | 95 | 4/10/2026 |
| 1.4.0 | 97 | 4/10/2026 |
| 1.3.1 | 102 | 4/8/2026 |
| 1.3.0 | 105 | 4/8/2026 |
| 1.2.0 | 104 | 4/7/2026 |
| 1.1.0 | 106 | 4/7/2026 |
| 1.0.0 | 102 | 4/6/2026 |
| 0.7.1 | 107 | 4/6/2026 |
| 0.7.0 | 97 | 4/6/2026 |
| 0.6.0 | 111 | 4/4/2026 |
v2.1.0: MCP Elicitation on explicit paid search engines (Serper/Tavily/SerpApi) when the API key is not configured — falls through to a "use free search instead?" prompt before soft-failing. Auto-detect mode keeps free fallback as before. FieldCure.DocumentParsers upgraded to 2.x (core now carries PDF text extraction); OCR is no longer bundled — use fieldcure-mcp-rag for scanned PDFs. IElicitGate abstraction and ApiKeyResolverRegistry with Invalidate for unit-testable credential resolution.