MCPgee
MCPgee
MCPgeeMCPgee

Sample MCP Server

v1.0.0•Search & Data Extraction•stable

Mcp server with local RAG on pdf and word documents and web search

samplemcpservermcpai-integration
Share:
11
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Sample MCP Server?

Sample MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server with local rag on pdf and word documents and web search

Mcp server with local RAG on pdf and word documents and web search

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Mcp server with local RAG on pdf and word documents and web

Use Cases

Perform local RAG (Retrieval-Augmented Generation) on PDF and Word documents.
Conduct web searches and extract information using AI.
virex-84

Maintainer

LicenseMIT
Languagec#
Versionv1.0.0
UpdatedApr 25, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx samplemcpserver

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Sample MCP Server

Sample MCP Server is a .NET-based MCP server that combines local Retrieval-Augmented Generation over PDF, Word, Excel, and PowerPoint documents with web search capabilities. It uses FAISS for local vector indexing and supports multiple search engines including DuckDuckGo, Firecrawl, and Baidu, making it a practical template for building document-aware AI assistants in C#.

Prerequisites

  • .NET SDK 8.0 or later installed
  • Git installed to clone the repository
  • A local LLM server or embedding service accessible (e.g., LM Studio running on localhost:1234)
  • Optional: Firecrawl API key for enhanced web search
  • Optional: GitHub personal access token for GitHub code search
1

Clone the repository

Clone the SampleMcpServer repository to your local machine.

git clone https://github.com/virex-84/SampleMcpServer.git
cd SampleMcpServer
2

Build the project

Restore NuGet packages and build the .NET solution.

dotnet build
3

Configure the MCP server settings

Create or edit the mcp.json configuration file to set environment variables including the embedding endpoint, model, and search engine settings.

{
  "env": {
    "WEB_SEARCH_ENGINES": "DuckDuckGo,Firecrawl",
    "WEB_SEARCH_FirecrawApiKey": "your_firecrawl_api_key",
    "WEB_SEARCH_duckduckgoRegion": "en-en",
    "GUTHUB_TOKEN": "ghp_your_github_token",
    "EMBEDD_ENDPOINT": "http://localhost:1234/v1/",
    "EMBEDD_MODEL": "text-embedding-nomic-embed-text-v2-moe",
    "EMBEDD_KEY": ""
  }
}
4

Configure Claude Desktop to run the server

Add the server to your claude_desktop_config.json pointing to the built .NET executable.

{
  "mcpServers": {
    "samplemcpserver": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/SampleMcpServer"],
      "env": {
        "WEB_SEARCH_ENGINES": "DuckDuckGo",
        "EMBEDD_ENDPOINT": "http://localhost:1234/v1/",
        "EMBEDD_MODEL": "text-embedding-nomic-embed-text-v2-moe",
        "EMBEDD_KEY": ""
      }
    }
  }
}
5

Index local documents for RAG

Place your PDF, DOCX, XLSX, PPTX, or TXT files in the designated documents directory. The rag tool will automatically index and retrieve from them when prompted.

Sample MCP Server Examples

Client configuration

claude_desktop_config.json entry for the SampleMcpServer .NET MCP server with DuckDuckGo search and a local embedding endpoint.

{
  "mcpServers": {
    "samplemcpserver": {
      "command": "dotnet",
      "args": ["run", "--project", "/Users/yourname/SampleMcpServer"],
      "env": {
        "WEB_SEARCH_ENGINES": "DuckDuckGo",
        "WEB_SEARCH_duckduckgoRegion": "en-en",
        "EMBEDD_ENDPOINT": "http://localhost:1234/v1/",
        "EMBEDD_MODEL": "text-embedding-nomic-embed-text-v2-moe",
        "EMBEDD_KEY": ""
      }
    }
  }
}

Prompts to try

Example prompts to use with SampleMcpServer once connected to Claude Desktop.

- "Search the web for the latest news about .NET 9 performance improvements"
- "Find information in my local documents about the Q3 budget report"
- "Search GitHub for repositories that implement MCP servers in C#"
- "Calculate the square root of 2048"
- "Read the file at /documents/notes.txt and summarize its key points"
- "What does my local PDF about project requirements say about authentication?"

Troubleshooting Sample MCP Server

dotnet build fails with missing NuGet packages

Run dotnet restore before dotnet build to ensure all NuGet packages are downloaded. If behind a corporate proxy, configure the NuGet proxy settings in your NuGet.Config file.

RAG tool returns no results for document queries

Verify the embedding service is running at the URL specified in EMBEDD_ENDPOINT. If using LM Studio, ensure the server is started and the embedding model is loaded. Check that documents are placed in the correct directory expected by the server.

Web search returns errors or no results

Confirm the WEB_SEARCH_ENGINES value matches available providers (DuckDuckGo, Firecrawl, or Baidu). For Firecrawl, ensure WEB_SEARCH_FirecrawApiKey is set to a valid API key from firecrawl.dev.

Frequently Asked Questions about Sample MCP Server

What is Sample MCP Server?

Sample MCP Server is a Model Context Protocol (MCP) server that mcp server with local rag on pdf and word documents and web search It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Sample MCP Server?

Follow the installation instructions on the Sample MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Sample MCP Server?

Sample MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Sample MCP Server free to use?

Yes, Sample MCP Server is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Sample MCP Server Alternatives — Similar Search & Data Extraction Servers

Looking for alternatives to Sample MCP Server? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.

TrendRadar

★ 58.0k

A real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va

Scrapling

★ 52.7k

🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!

PDF Math Translate

★ 33.9k

[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero

GPT Researcher

★ 27.2k

An autonomous agent that conducts deep research on any data using any LLM providers

Agent Reach

★ 20.1k

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

Xiaohongshu

★ 13.7k

MCP for xiaohongshu.com

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Search & Data ExtractionBrowse All Servers

Quick Config Preview

{ "mcpServers": { "samplemcpserver": { "command": "npx", "args": ["-y", "samplemcpserver"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Sample MCP Server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides