Cover image
Try Now
2025-04-04

3 years

Works with Finder

1

Github Watches

0

Github Forks

0

Github Stars

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

相关推荐

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • https://zenepic.net
  • Embark on a thrilling diplomatic quest across a galaxy on the brink of war. Navigate complex politics and alien cultures to forge peace and avert catastrophe in this immersive interstellar adventure.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • https://reddgr.com
  • Delivers concise Python code and interprets non-English comments

  • 林乔安妮
  • A fashion stylist GPT offering outfit suggestions for various scenarios.

  • 1Panel-dev
  • 💬 MaxKB is a ready-to-use AI chatbot that integrates Retrieval-Augmented Generation (RAG) pipelines, supports robust workflows, and provides advanced MCP tool-use capabilities.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • Dhravya
  • Collection of apple-native tools for the model context protocol.

  • open-webui
  • User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

  • GLips
  • MCP server to provide Figma layout information to AI coding agents like Cursor

    Reviews

    1 (1)
    Avatar
    user_KC0QBLMX
    2025-04-17

    I have been using mcp-server by khaosans and I'm thoroughly impressed. The server performs exceptionally well with a clean and efficient codebase. The documentation on the GitHub page is comprehensive and easy to follow. It’s evident that a lot of thought has been put into optimizing performance. Highly recommend for any project needing a robust server solution!