🤖 AI 开发助手 MCP 服务器

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

✨ 功能

🎨 代码架构师

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

📸 截图助手

拍摄 UI 设计截图，并将其与 Composer 代理一起使用。

🔍 代码审查

使用 git diff 触发代码审查。

🚀 快速开始

1. 环境设置

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

export const OPENAI_API_KEY = "your_key_here";
// 添加您需要的任何其他密钥

⚠️ 安全提示：不建议在生产环境中直接将 API 密钥存储在源代码中。这仅用于本地开发和学习目的。您也可以在 Cursor MCP 界面中内联设置 env var。

2. 安装

npm install
# 或
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    # 代码结构生成器
│   ├── screenshot.ts   # 截图分析工具
│   └── codeReview.ts   # 代码审查工具
├── env/
│   └── keys.ts         # 环境配置（在此处添加您的 API 密钥！）
└── index.ts           # 主入口点

🤝 贡献

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

📝 许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

🐛 问题 & 支持

发现错误或需要帮助？打开一个 issue，并提供：

1. 您尝试做什么
2. 发生了什么
3. 重现步骤
4. 您的环境详细信息

---

老实说，这是一个教程演示，而不是一个生产就绪的工具，所以我可能不会修复问题。但请随意 fork 它并使其成为您自己的！

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