AI Development Assistant MCP Server

🤖 AI Development Assistant MCP Server

Bem-vindo ao seu kit de ferramentas de desenvolvimento com IA, projetado como um servidor Model Context Protocol (MCP) para o Cursor! Este projeto fornece assistência inteligente de codificação por meio de ferramentas de IA personalizadas. Observe que este é principalmente um demo de tutorial, e não uma ferramenta pronta para produção.

✨ Recursos

🎨 Code Architect

Chame LLMs de raciocínio avançado para gerar planos e instruções para agentes de codificação.

📸 Screenshot Buddy

Tire capturas de tela de designs de UI e use-as com o agente compositor.

🔍 Code Review

Use diffs do git para acionar revisões de código.

📄 Ler arquivo & Ler múltiplos arquivos

A leitura de um único arquivo permite uma análise eficiente de dados; a leitura de múltiplos arquivos facilita o processamento em lote de dados.

🚀 Começando

1. Configuração do Ambiente

Primeiro, você precisará configurar suas variáveis de ambiente. Crie um arquivo em src/env/keys.ts:

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

⚠️ Nota de Segurança: Armazenar chaves de API diretamente no código-fonte não é recomendado para ambientes de produção. Isso é apenas para desenvolvimento local e fins de aprendizado. Você também pode definir a variável de ambiente inline na interface MCP do Cursor.

2. Instalação

npm install
# or
yarn install

3. Compile o Servidor

npm run build

4. Abra o Windsurf Chat e Configure o MCP

Este projeto foi projetado para ser usado como um servidor MCP no Cursor. Veja como configurá-lo:

1. Abra o Windsurf no seu sistema.
2. Navegue até a seção Chat.
3. Clique em + Configure MCP (isso permite adicionar um novo servidor MCP).
4. Adicione a seguinte configuração JSON:

{
  "mcpServers": {
    "mcp-server": {
      "command": "node",
      "args": [
        "D:\\mpc-server\\build\\index.js"
      ]
    }
  }
}

📘 Dica Profissional: Você pode precisar usar o caminho completo para o arquivo index.js compilado do seu projeto.

Após adicionar o servidor, você deve ver suas ferramentas listadas em "Available Tools". Se não, tente clicar no botão de atualizar no canto superior direito da seção do servidor MCP.

Para mais detalhes sobre a configuração do MCP, consulte a Documentação MCP do Windsurf.

🛠️ Usando as Ferramentas

Uma vez configurado, você pode usar essas ferramentas diretamente no Composer do Cursor. A IA sugerirá automaticamente o uso de ferramentas relevantes, ou você pode solicitá-las explicitamente pelo nome ou descrição.

Por exemplo, tente digitar no Composer:

• "Revise este código para boas práticas"
• "Ajude-me a arquitetar um novo recurso"
• "Analise esta captura de tela de UI"
• "Ler arquivo único & Ler múltiplos arquivos"

O agente pedirá sua aprovação antes de fazer qualquer chamada de ferramenta.

📘 Dica Profissional: Você pode atualizar seu arquivo .cursorrules com instruções sobre como usar as ferramentas para determinados cenários, e o agente usará as ferramentas automaticamente.

📁 Estrutura do Projeto

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

---