virex-84/SampleMcpServer

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

1. Build the project:

   dotnet build
   

2. Run the server:

   dotnet run
   

3. 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.