mcp-server

mcp-server

0
file_systemscommunicationdeveloper_tools

The MCP Server is a FastAPI-based application designed for efficient WebSocket communication, file management, and tool execution. It serves static files and includes a comprehensive testing suite, making it a versatile server solution.

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
  1. Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\activate
  1. 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