🤖 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 接口中内联设置环境变量。

2. 安装

npm install
# 或
yarn install

3. 构建服务器

npm run build

4. 添加到 Cursor

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

打开 Cursor
前往 Cursor 设置 > 功能 > MCP
点击 + 添加新的 MCP 服务器
填写表单：
- 名称: 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           # 主要入口点

🤝 贡献

欢迎贡献！请随时提交拉取请求。

📝 许可证

本项目采用 MIT 许可证授权 - 详情请见LICENSE文件。

🐛 问题与支持

发现 bug 或需要帮助？请按以下步骤提交问题：

你想做什么
实际发生了什么
重现步骤
你的环境详情

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

由开发者，为开发者倾情打造 ❤️