mcpField
M
MCP Server

MCP Server

Local
github.com/khaosansDeveloper Tools0Updated 82w ago
Repository

About MCP Server

MCP Server is a FastAPI-based server combining file management, WebSocket communication, and tool endpoints. It also serves static files and includes a test suite.

Key features

  1. 01File search and reading API
  2. 02WebSocket communication
  3. 03Tool execution endpoint
  4. 04Static file serving
  5. 05Test suite

Use cases

  1. 01Search files in the public directory
  2. 02Read a specific file by name
  3. 03Run the summarization tool

MCP support

The project describes itself as an MCP server and provides a tools endpoint for executing tools; the listed endpoint currently supports summarization.

#mcp-server#fastapi#websocket

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.