AI开发助手 MCP 服务器

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

✨ 特性

🎨 代码架构师

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

📸 屏幕截图助手

使用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-only

# 开发模式（监视更改）
npm run dev

# 运行服务器
npm run start

# 使用PM2部署
npm run pm2

# 其他PM2命令
npm run stop      # 停止服务器
npm run restart   # 重新启动服务器
npm run logs      # 查看服务器日志
npm run status    # 检查服务器状态

4. 添加到Cursor

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

1. 打开Cursor
2. 转到 Cursor 设置 > 功能 > MCP
3. 点击 + 添加新MCP服务器
4. 填写表单：
   • 名称：AI开发助手
   • 类型：stdio
   • 命令：node /path/to/your/project/build/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 了解详细信息。

🚀 快速开始

要开始使用，请执行以下步骤：

1. 克隆仓库：

   git clone https://github.com/yourusername/ai-dev-assistant-mcp.git
   cd ai-dev-assistant-mcp
   

2. 安装依赖项：

   npm install
   # 或者使用Yarn
   yarn install
   

3. 配置API密钥：
   • 创建 src/env/keys.ts 文件并添加您的OpenAI API密钥。
4. 运行服务器：

   npm run start
   

📋 注意事项

• 确保始终在受信任的网络上使用此工具，以防止API密钥泄露。
• 定期更新依赖项以保持安全性和性能。

我们希望这个项目能帮助您提升开发效率！如果有任何问题或建议，请随时与我们联系。