Windsurf MCP Server

by rohanbanda-TRT

Development/IDE & Editors FastAPI WebSocket Windsurf API

The MCP server extends Windsurf's capabilities by providing additional tools not built into Windsurf. It uses FastAPI with WebSocket support for real-time communication.

View on GitHub

Last updated: N/A

What is Windsurf MCP Server?

The MCP server is a Master Control Program server designed to extend the functionality of the Windsurf agentic IDE by providing additional tools and real-time communication capabilities.

How to use Windsurf MCP Server?

Clone the repository. 2. Create and activate a virtual environment. 3. Install dependencies using pip install -r requirements.txt. 4. Start the server with python main.py. 5. Configure Windsurf to connect to the WebSocket endpoint ws://localhost:8089/ws. 6. Access API documentation at http://localhost:8089/docs.

Key features of Windsurf MCP Server

FastAPI Backend
WebSocket Support
Extensible Tool System
RESTful API
Windsurf Integration

Use cases of Windsurf MCP Server

Extending Windsurf IDE with custom tools
Real-time communication between Windsurf and external services
Automating tasks within the Windsurf environment
Code analysis and manipulation
File management and search

FAQ from Windsurf MCP Server

What is FastAPI?

FastAPI is a modern, high-performance web framework for building APIs with Python 3.7+ based on standard Python type hints.

What is WebSocket?

WebSocket is a communication protocol that provides full-duplex communication channels over a single TCP connection.

How do I add a custom tool?

Open tools.py, use the @register_tool decorator to register your tool, and implement the tool's logic in the associated handler function.

What are the available API endpoints?

The API endpoints include GET / for server information, GET /tools to list available tools, POST /tools/{tool_name} to execute a tool, and WebSocket /ws for real-time communication.

What license is the project under?

The project is licensed under the MIT License.