Advertise
MCP.so
Sign In

MCP Server

@avinash539

Repository

Basic information

Category

Other

License

Apache-2.0 license

Transports

stdio

Author

avinash539

About MCP Server

This is a repository for mcp servers

MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-avinash539": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp-server",
        "."
      ]
    }
  }
}

MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server?

MCP Server is an implementation of the Model Context Protocol (MCP) that provides tools for AI agents and LLMs — including web search via SearXNG and secure file system operations. It is intended for developers building AI applications that need sandboxed tool access.

How to use MCP Server?

You can deploy MCP Server with Docker (recommended) or install directly using Python 3.13 and the uv package manager. The server is started via the command python -m mcp_server start and can be configured through environment variables or integrated with the Claude Desktop client using a claude_desktop_config.json entry.

Key features of MCP Server

  • Web search with customizable parameters via SearXNG
  • File system read, write, and list operations
  • Extensible architecture for adding custom tools
  • Docker and docker-compose deployment support
  • Command-line interface for server management
  • Full MCP specification support for resources and prompts

Use cases of MCP Server

  • AI agents performing web searches with language, time, and category filters
  • LLMs reading, writing, or appending to local files under access controls
  • Developers prototyping and testing custom MCP tools using FastMCP decorators
  • Containerized deployment of an MCP server alongside a SearXNG instance

Frequently asked questions

1

What are the runtime requirements?

Python 3.13 is required, along with MCP SDK ≥ 1.6.0 and the uv package manager. Docker is optional but recommended.

2

How do I run the server?

You can either build and run the Docker image (`docker build -t mcp-server && docker-compose up`) or install directly with uv and run `python -m mcp_server start`.

3

Does MCP Server include its own search engine?

No. Web search requires a running SearXNG instance. You must provide its URL via the `MCP_SEARXNG__INSTANCE_URL` environment variable.

4

What configuration options are available?

The server is configured through environment variables covering host/port (e.g., `MCP_SERVER__HOST`, `MCP_SERVER__PORT`), SearXNG settings, log level, and a data directory.

5

How can I add custom tools?

You can extend the server using the FastMCP decorator approach (`@mcp.tool()`) or by following the original architecture documented in the developer guide.

Comments

More Other MCP servers

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Advertise