🤖 AI 开发助手 MCP 服务器

欢迎来到您的AI驱动开发工具包，该工具包作为Cursor的模型上下文协议（MCP）服务器设计。此项目通过自定义AI工具提供智能编码辅助。请注意，这主要是教程演示，并非生产就绪工具。

✨ 功能

🎨 代码架构师

调用高级推理LLMs生成编码代理的计划和指令。

📸 屏幕截图助手

拍摄UI设计截图并将其与作曲家代理一起使用。

🔍 代码审查

使用git diff触发代码审查。

📄 读取文件及读取多个文件

单文件读取可实现高效数据分析；多文件读取有助于批量数据处理。

</br>

🚀 快速开始

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服务器部分右上角的刷新按钮。

有关MCP设置的更多详细信息，请参阅Windsurf MCP文档。

</br>

🛠️ 使用工具

配置完成后，您可以在Cursor的Composer中直接使用这些工具。AI会自动建议使用相关工具，或者您可以按名称或描述明确请求它们。

例如，在Composer中尝试输入：

• “审查这段代码的最佳实践”
• “帮助我架构新功能”
• “分析这个UI截图”
• “读取单个文件及读取多个文件”

代理会在执行任何工具调用之前询问您的批准。

📘 专业提示：您可以通过更新.cursorrules文件来指定如何在特定场景中使用工具，代理将自动使用这些工具。

</br>

📁 项目结构

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