🤖 AI 开发助手 MCP 服务器

欢迎使用您的 AI 驱动的开发工具包，这是一个为 Cursor 设计的 Model Context Protocol (MCP) 服务器！该项目通过自定义 AI 工具提供智能编码辅助。请注意，这主要是教程演示，并不是一个生产就绪的工具。

✨ 功能

🎨 代码架构师

调用高级推理 LLM 来为编码代理生成计划和说明。

📸 截图助手

截取 UI 设计截图并使用它们与作曲代理一起工作。

🔍 代码审查

使用 git diffs 触发代码审查。

🚀 入门指南

1. 环境设置

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

export const OPENAI_API_KEY = "your_key_here";
// Add any other keys you need

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

2. 安装

npm install
# or
yarn install

3. 构建服务器

npm run build

4. 添加到 Cursor

此项目旨在作为 Cursor 中的 MCP 服务器使用。以下是设置方法：

1. 打开 Cursor
2. 转到 Cursor 设置 > 功能 > MCP
3. 点击 + 添加新的 MCP 服务器
4. 填写表单：
   • 名称: AI 开发助手
   • 类型: stdio
   • 命令: node /path/to/your/project/dist/index.js

📘 专业提示：您可能需要使用项目的构建 index.js 文件的完整路径。

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

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

🛠️ 使用工具

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

例如，在 Composer 中尝试输入：

• "审查这段代码的最佳实践"
• "帮助我设计一个新功能"
• "分析这个 UI 截图"

代理将在进行任何工具调用之前征求您的批准。

📘 专业提示：您可以在 .cursorrules 文件中更新有关如何在某些场景下使用工具的说明，代理将自动使用这些工具。

📁 项目结构

src/
├── tools/
│   ├── architect.ts    # Code structure generator
│   ├── screenshot.ts   # Screenshot analysis tool
│   └── codeReview.ts   # Code review tool
├── env/
│   └── keys.ts         # Environment configuration (add your API keys here!)
└── index.ts           # Main entry point

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📝 许可证

此项目根据 MIT 许可证发布 - 详情请参见 LICENSE 文件。

🐛 问题与支持

发现错误或需要帮助？请打开一个 issue 并提供以下信息：

1. 您试图做什么
2. 实际发生了什么
3. 复现步骤
4. 您的环境详情

老实说，这只是一个教程演示，并不是一个生产就绪的工具，所以我可能不会修复问题。但欢迎您 fork 它并自己改进！

由开发者为开发者用心制作 ❤️