Windsurf 的 MCP 服务器

主控程序 (MCP) 服务器，为 Windsurf 代理 IDE 提供额外的工具。

概述

此 MCP 服务器旨在通过提供 Windsurf 内置功能之外的额外工具来扩展 Windsurf 的功能。 它使用 FastAPI 创建一个强大的 API 服务器，并支持 WebSocket，用于与 Windsurf 进行实时通信。

功能

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

项目结构

MCP_servers/
├── main.py                 # 主要的 FastAPI 应用程序
├── tools.py                # 自定义工具实现
├── windsurf_integration.py # Windsurf 集成模块
├── requirements.txt        # 项目依赖
└── README.md               # 文档

内置工具

MCP 服务器带有几个内置工具：

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

安装

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. 通过将 WebSocket 连接配置为以下地址，将 Windsurf 连接到 MCP 服务器：

   ws://localhost:8089/ws
   

3. 访问 API 文档：http://localhost:8089/docs

添加自定义工具

要向 MCP 服务器添加新工具：

1. 打开 tools.py
2. 使用 @register_tool 装饰器注册您的工具：

@register_tool(
    name="my_custom_tool",
    description="工具功能的描述",
    parameters={
        "param1": {"type": "string", "description": "参数 1 的描述"},
        "param2": {"type": "integer", "description": "参数 2 的描述"}
    }
)
async def my_custom_tool_handler(params: Dict[str, Any]) -> Any:
    # 工具实现
    param1 = params.get("param1", "")
    param2 = params.get("param2", 0)
    
    # 使用参数做一些事情
    result = f"已处理 {param1}，值为 {param2}"
    
    return {"output": result}

API 端点

• GET /: 服务器信息
• GET /tools: 列出所有可用工具
• POST /tools/{tool_name}: 执行特定工具
• WebSocket /ws: 用于实时通信的 WebSocket 端点

许可证

MIT