Windsurf Tools

🚀 🤖 AI开发助手 MCP 服务器

本项目是一款由AI驱动的开发工具包，专为Cursor的Model Context Protocol (MCP) 服务器量身打造！它借助自定义AI工具，为开发者提供智能编码辅助，有效提升编码效率与质量。

⚠️ 重要提示

这是一个主要用于本地开发和学习的教程演示项目，并非生产就绪工具。

✨ 主要特性

🎨 代码架构师

调用高级推理大语言模型（LLM），为编码代理生成计划和指令，助力构建高效、合理的代码架构。

📸 截图帮手

捕获UI设计截图，并与作曲家代理协同工作，方便进行UI相关的开发与分析。

🔍 代码审查

通过git差异触发代码审查，精准定位代码中的问题和优化点。

📄 读取文件 & 读取多个文件

单文件阅读可显著提高数据解析效率；多文件阅读则便于批量处理数据，满足不同场景的需求。

🚀 快速开始

1. 环境配置

首先，您需要设置环境变量。创建一个位于 src/env/keys.ts 的文件：

export const OPENAI_API_KEY = "your_key_here";
// 添加其他所需的密钥

⚠️ 安全提示：在生产环境中直接将API密钥存储在源代码中是不推荐的。这只是用于本地开发和学习目的。您也可以直接在Cursor MCP界面中设置环境变量。

2. 安装

npm install
# 或者
yarn install

3. 构建服务器

npm run build

4. 打开Windsurf聊天并配置MCP

该项目设计为Cursor的MCP服务器。以下是设置方法：

1. 在您的系统上打开Windsurf。
2. 导航到“聊天”部分。
3. 点击 + 配置MCP（这允许您添加一个新的MCP服务器）。
4. 添加以下JSON配置：

{
  "mcpServers": {
    "mcp-server": {
      "command": "node",
      "args": [
        "D:\\mpc-server\\build\\index.js"
      ]
    }
  }
}

📘 技巧：您可能需要使用项目构建索引.js文件的完整路径。

添加服务器后，您应该在“可用工具”下看到您的工具。如果没有，请尝试点击MCP服务器部分右上角的刷新按钮。

有关更多设置详情，请参阅 Windsurf MCP 文档。

🛠️ 使用示例

基础用法

一旦配置完成，您就可以在Cursor的作曲家中直接使用这些工具。AI会自动建议使用相关工具，或者您可以明确要求使用名称或描述的工具。

例如，在作曲家中尝试输入：

• "审查此代码的最佳实践"
• "帮助我架构新功能"
• "分析此UI截图"
• "读取单个文件 & 读取多个文件"

代理会询问您的批准后再调用任何工具。

高级用法

您可以更新.cursorrules文件，添加在特定场景下使用工具的说明，代理将自动使用工具，进一步提升开发效率。

📚 详细文档

项目结构

src/
├── tools/
│   ├── architect.ts    # 代码结构生成器
│   ├── screenshot.ts   # 截图分析工具
│   ├── fileReader.ts  # 读取文件 & 读取多个文件工具
│   └── codeReview.ts   # 代码审查工具
├── env/
│   └── keys.ts         # 环境配置（在此处添加您的API密钥！）
└── index.ts           # 入口起点