SampleMcpServer

Name: SampleMcpServer
Author: virex-84

by virex-84

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

11 6 tools GitHub

No known CVEs

No license

Stale

Last commit 205d ago

Works with most clients

Transport: stdio

6 tools · ~259 tok

Grade A · 0.1% of 200K ctx

Edit this pageView history

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "my-mcp-example": {
      "env": {
        "EMBEDD_KEY": "",
        "EMBEDD_MODEL": "text-embedding-nomic-embed-text-v2-moe",
        "GUTHUB_TOKEN": "github_pat_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
        "EMBEDD_ENDPOINT": "http://localhost:1234/v1/",
        "WEB_SEARCH_ENGINES": "DuckDuckGo,Firecraw, Baidu",
        "WEB_SEARCH_FirecrawApiKey": "fc-xxxxxxxxxxxxxxxxxxxxxxxxxx",
        "WEB_SEARCH_duckduckgoRegion": "en-en"
      },
      "command": "C:\\path_to_exe_file\\SampleMcpServer.exe"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/samplemcpserver)](https://mcppedia.org/s/samplemcpserver)

Read me

What SampleMcpServer does

This is a sample server that demonstrates how to implement an MCP (Model Context Protocol) server using .NET.

Test This Server

No automated test available for this server. Check the GitHub README for setup instructions.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

62/100across 5 weighted dimensions

How we score →

0255075100

−38

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (6)

Click any tool to inspect its schema.

~259 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is SampleMcpServer safe to use?: SampleMcpServer has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install SampleMcpServer?: SampleMcpServer supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can SampleMcpServer do?: SampleMcpServer provides 6 tools: random_number, calc, file_operations, internet_search, github_search and 1 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with SampleMcpServer?: SampleMcpServer is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is SampleMcpServer actively maintained?: SampleMcpServer is less actively maintained — last commit was 205 days ago. It has 11 GitHub stars.

Similar servers

Others in search

View all →

Brave Search MCP Server98

Web and local search using Brave Search API

86.4k 2

Modelcontextprotocol96

The official MCP server implementation for the Perplexity API Platform

2.2k 4

Tavily Mcp96

Production ready MCP server with real-time search, extract, map & crawl.

2.0k 4

Context795

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

56.3k 2

MCP Security Weekly

Get CVE alerts and security updates for SampleMcpServer and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

{ "mcpServers": { "my-mcp-example": { "env": { "EMBEDD_KEY": "", "EMBEDD_MODEL": "text-embedding-nomic-embed-text-v2-moe", "GUTHUB_TOKEN": "github_pat_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy", "EMBEDD_ENDPOINT": "http://localhost:1234/v1/", "WEB_SEARCH_ENGINES": "DuckDuckGo,Firecraw, Baidu", "WEB_SEARCH_FirecrawApiKey": "fc-xxxxxxxxxxxxxxxxxxxxxxxxxx", "WEB_SEARCH_duckduckgoRegion": "en-en" }, "command": "C:\\path_to_exe_file\\SampleMcpServer.exe" } } }

Tools

random_number: Generate random numbers

calc: Perform calculation: add, subtract, multiply, divide, power, square root

file_operations: Read, write, and list files

internet_search: Search the web with DuckDuckGo, Firecraw and Baidu

github_search: Search GitHub repositories and code

rag: Retrieve information from local files with FAISS: pdf, docx, xlsx, pptx, other text

Usage

Example configuration in LM Studio (mcp.json):

{ "mcpServers": { "my-mcp-example": { "command": "C:\\path_to_exe_file\\SampleMcpServer.exe", "env": { "WEB_SEARCH_ENGINES": "DuckDuckGo,Firecraw, Baidu", "WEB_SEARCH_FirecrawApiKey": "fc-xxxxxxxxxxxxxxxxxxxxxxxxxx", "WEB_SEARCH_duckduckgoRegion": "en-en", "GUTHUB_TOKEN": "github_pat_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy", "EMBEDD_ENDPOINT": "http://localhost:1234/v1/", "EMBEDD_MODEL": "text-embedding-nomic-embed-text-v2-moe", "EMBEDD_KEY": "" } } } }

Frequently Asked Questions

Is SampleMcpServer safe to use?

SampleMcpServer has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install SampleMcpServer?

SampleMcpServer supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can SampleMcpServer do?

SampleMcpServer provides 6 tools: random_number, calc, file_operations, internet_search, github_search and 1 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with SampleMcpServer?

SampleMcpServer is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is SampleMcpServer actively maintained?

SampleMcpServer is less actively maintained — last commit was 205 days ago. It has 11 GitHub stars.

Sample MCP Server

This is a sample server that demonstrates how to implement an MCP (Model Context Protocol) server using .NET.

Tools

random_number: Generate random numbers
calc: Perform calculation: add, subtract, multiply, divide, power, square root
file_operations: Read, write, and list files
internet_search: Search the web with DuckDuckGo, Firecraw and Baidu
github_search: Search GitHub repositories and code
rag: Retrieve information from local files with FAISS: pdf, docx, xlsx, pptx, other text

FaissVectorStore (as InMemoryVectorStore) on GitHub Gist

Getting Started

Build the project:
```
dotnet build
```
Run the server:
```
dotnet run
```
Connect your MCP client to this server using the stdio transport.

Usage

Example configuration in LM Studio (mcp.json):

{
  "mcpServers": {
    "my-mcp-example": {
      "command": "C:\\path_to_exe_file\\SampleMcpServer.exe",
      "env": {
        "WEB_SEARCH_ENGINES": "DuckDuckGo,Firecraw, Baidu",
        "WEB_SEARCH_FirecrawApiKey": "fc-xxxxxxxxxxxxxxxxxxxxxxxxxx",
        "WEB_SEARCH_duckduckgoRegion": "en-en",
        "GUTHUB_TOKEN": "github_pat_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
        "EMBEDD_ENDPOINT": "http://localhost:1234/v1/",
        "EMBEDD_MODEL": "text-embedding-nomic-embed-text-v2-moe",
        "EMBEDD_KEY": ""        
      }
    }
  }
}

License

This project is licensed under the MIT License.