MCP Server

@khaosans

About MCP Server

No overview available yet

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.

Can I run automated tests?

Yes, run python test_server.py to execute the included test suite.

Does MCP Server support authentication?

No authentication is mentioned in the README. The server runs on HTTP and WebSocket without built-in auth.

Frequently asked questions

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.

Can I run automated tests?

Yes, run `python test_server.py` to execute the included test suite.

Does MCP Server support authentication?

No authentication is mentioned in the README. The server runs on HTTP and WebSocket without built-in auth.

Comments

Basic information

More Other MCP servers

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K