🤖 AI Development Assistant MCP Server

🤖 AI Development Assistant MCP Server

site icon
2025.03.06 6
TypeScriptAI 开发助手代码辅助工具开发效率
mcp-server 是一个基于 Model Context Protocol (MCP) 的 AI 开发助手工具包,旨在为 Cursor 提供智能编码辅助功能。它通过自定义 AI 工具集,帮助开发者进行代码架构设计、UI 截图分析、代码审查以及文件读取等操作。该项目主要作为教程演示,而非生产就绪的工具。
View on GitHub

Overview

✨ 核心功能

  1. 代码架构师:调用高级推理 LLM 生成编码代理的计划和指令。
  2. 截图助手:获取 UI 设计截图并与 composer 代理一起使用。
  3. 代码审查:使用 git diff 触发代码审查。
  4. 文件读取:支持单文件读取(高效数据分析)和多文件读取(批量数据处理)。

🛠️ 工具列表

  • architect.ts:代码结构生成器。
  • screenshot.ts:截图分析工具。
  • fileReader.ts:单文件和多文件读取工具。
  • codeReview.ts:代码审查工具。

🚀 使用场景

  1. 代码架构设计。
  2. UI 设计分析。
  3. 代码质量审查。
  4. 批量文件数据处理。

🛠️ 使用教程

1. 环境设置

创建 src/env/keys.ts 文件并设置环境变量:

export const OPENAI_API_KEY = "your_key_here";

2. 安装依赖

npm install
# 或
yarn install

3. 构建服务器

npm run build

4. 配置 MCP 服务器

  1. 打开 Windsurf。
  2. 导航到 Chat 部分。
  3. 点击 + Configure MCP
  4. 添加以下 JSON 配置:
{
  "mcpServers": {
    "mcp-server": {
      "command": "node",
      "args": [
        "D:\\mpc-server\\build\\index.js"
      ]
    }
  }
}

5. 调试方式

在 Composer 中尝试输入以下命令以测试工具:

  • "Review this code for best practices"
  • "Help me architect a new feature"
  • "Analyze this UI screenshot"
  • "Read single file & Read multiple files"

❓ 常见问题

  1. API 密钥安全:不建议在生产环境中直接存储 API 密钥,仅用于本地开发和学习。
  2. 工具未列出:尝试刷新 MCP 服务器部分的右上角按钮。
  3. 路径问题:可能需要使用项目的完整路径到 index.js 文件。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。