MCP Server
Description
# MCP Server A FastAPI-based server providing WebSocket communication, file management, and tools endpoints. ## π Features - π File Management API - π WebSocket Communication - π οΈ Tools Endpoint - π Static File Serving - β Comprehensive Test Suite ## π οΈ Installation 1. Clone theβ¦
About
# MCP Server A FastAPI-based server providing WebSocket communication, file management, and tools endpoints. ## π Features - π File Management API - π WebSocket Communication - π οΈ Tools Endpoint - π Static File Serving - β Comprehensive Test Suite ## π οΈ Installation 1. Clone the repository: ```bash git cloneβ¦
Details
- Author
- khaosans
- Downloads
- 271
- Categories
- Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server": {
"mcp-server-khaosans": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
}
}
McpServers
{
"mcp-server-khaosans": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
MCP Server
A FastAPI-based server providing WebSocket communication, file management, and tools endpoints.
π Features
- π File Management API
- π WebSocket Communication
- π οΈ Tools Endpoint
- π Static File Serving
- β
Comprehensive Test Suite
π οΈ Installation
1. Clone the repository:
git clone https://github.com/khaosans/mcp-server.git
cd mcp-server
2. Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows: .\venv\Scripts\activate
3. Install dependencies:
pip install -r requirements.txt
πββοΈ Running the Server
Start the server with:
uvicorn server:app --reload --host 0.0.0.0 --port 8080
π§ͺ Running Tests
Run the test suite with:
python test_server.py
π‘ API Endpoints
HTTP Endpoints
- GET /files?q=<query>: Search files in the public directory
- GET /files/{filename}: Read a specific file
- POST /tools: Execute tools (currently supports summarization)
- GET /public/*: Serve static files
WebSocket Endpoint
- ws://localhost:8080/ws: WebSocket endpoint for real-time communication
π License
MIT License
π€ Author
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



