MCP Server

by khaosans

271 downloads
Not rated
GitHub

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

- 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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

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

khaosans

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.