MCP Server for Windsurf

基本能力

产品定位

windsurf-mcp-integration 是一个为 Windsurf 代理式 IDE 提供额外工具的 MCP 服务器，旨在扩展 Windsurf 的功能。

核心功能

• FastAPI 后端：高性能、易用的框架
• WebSocket 支持：实时双向通信
• 可扩展的工具系统：轻松添加新工具以扩展 Windsurf
• RESTful API：用于工具执行的 HTTP 端点
• Windsurf 集成：与 Windsurf IDE 无缝集成

适用场景

• 需要扩展 Windsurf IDE 功能的开发者
• 需要实时通信和工具集成的开发环境
• 需要高性能 API 服务器的项目

工具列表

1. 文件搜索：在目录中搜索匹配模式的文件
2. 代码分析：分析代码文件的语法、复杂性和依赖关系
3. Web 请求：向外部 API 发起 HTTP 请求

常见问题解答

• 如何添加自定义工具？ 在 tools.py 中使用 @register_tool 装饰器注册新工具。
• 如何启动服务器？ 运行 python main.py 启动服务器。
• 如何连接 Windsurf？ 配置 WebSocket 连接到 ws://localhost:8089/ws。

使用教程

使用依赖

1. 克隆仓库
2. 创建虚拟环境： python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate
3. 安装依赖： pip install -r requirements.txt

安装教程

1. 启动 MCP 服务器： python main.py 服务器将在 http://localhost:8089 启动。
2. 连接 Windsurf 到 MCP 服务器，配置 WebSocket 连接到： ws://localhost:8089/ws
3. 访问 API 文档： http://localhost:8089/docs

调试方式

1. 启动服务器后，检查日志输出以确保服务器正常运行。
2. 使用 API 文档测试各个端点。
3. 通过 Windsurf IDE 测试工具集成和实时通信功能。

许可证

该项目遵循 MIT 开源许可条款。