MCP Server

Name: MCP Server
Author: khaosans

@khaosans

Repository

About MCP Server

No overview available yet

#mcp-server #fastapi #websocket

Basic information

Config

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

{
  "mcpServers": {
    "mcp-server-khaosans": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

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 a FastAPI-based server that provides WebSocket communication, file management, and a tools endpoint for summarization. It is designed for developers needing a lightweight backend with file search, real-time messaging, and static file serving.

How to use MCP Server?

Clone the repository, create a Python virtual environment, install dependencies from requirements.txt, then run the server with uvicorn server:app --reload --host 0.0.0.0 --port 8080. Use python test_server.py to run the test suite.

Key features of MCP Server

File Management API (search, read files)
WebSocket communication for real-time interactions
Tools endpoint supporting summarization
Static file serving from the public directory
Comprehensive test suite included

Use cases of MCP Server

Building a real-time chat or collaboration tool with file sharing
Serving static assets and providing file search in a local directory
Integrating lightweight summarization capabilities into an application
Prototyping a FastAPI backend with WebSocket and REST endpoints

FAQ from MCP Server

How do I install and run MCP Server?

Clone the repo, create a virtual environment, install dependencies, then run uvicorn server:app --reload --host 0.0.0.0 --port 8080.

What endpoints does MCP Server expose?

HTTP endpoints include GET /files?q=<query>, GET /files/{filename}, POST /tools, and GET /public/* for static files. A WebSocket endpoint is available at ws://localhost:8080/ws.

What are the runtime requirements?

Python 3, a virtual environment, and the packages in requirements.txt (including FastAPI and uvicorn). No external database or authentication is required.