Servidor MCP Agile Luminary

Este é um servidor Model Context Protocol (MCP) que conecta clientes de IA (como Cursor ou Claude Desktop) ao sistema de gerenciamento de projetos Agile Luminary hospedado em https://agileluminary.com.

O que é MCP?

O Model Context Protocol (MCP) é uma forma padronizada de aplicações de IA se conectarem a fontes de dados e serviços externos. Este servidor atua como uma ponte entre seu cliente de IA e a API REST do Agile Luminary, permitindo que você recupere detalhes de projetos, atribuições de trabalho e documentação diretamente em suas conversas com IA.

Arquitetura

AI Client (Cursor/Claude) → Local MCP Server → Agile Luminary API (localhost:5006)

Recursos

Este servidor MCP fornece três ferramentas principais que buscam dados da API do Agile Luminary:

📚 getRelatedDocuments

Propósito: Recuperar documentos relacionados com base em uma string de busca
Parâmetros: searchString (obrigatório) - O texto a ser pesquisado nos documentos
Caso de uso: Encontre documentação e especificações relevantes relacionadas ao seu trabalho atual

📋 getCurrentWork

Propósito: Busca o trabalho atualmente atribuído ao usuário
Parâmetros: Nenhum
Caso de uso: Veja quais tarefas e histórias de usuário estão ativamente atribuídas a você

🔍 getPastWork

Propósito: Recupera trabalhos concluídos relacionados a histórias de usuário com base em critérios de busca
Parâmetros: searchString (obrigatório) - Termo de busca para encontrar trabalhos anteriores relevantes
Caso de uso: Revise o contexto histórico e tarefas concluídas para melhor tomada de decisão

Instalação e Configuração

Pré-requisitos

Node.js (v16 ou superior)
Um cliente de IA que suporte MCP (Cursor IDE, Claude Desktop, etc.)

Instalar Dependências

npm install @modelcontextprotocol/sdk zod

Variáveis de Ambiente

Defina sua chave de API como uma variável de ambiente:

export LUMINARY_API_KEY=your_api_key_here

Executar o Servidor

node server.js

O servidor iniciará e aguardará conexões do seu cliente de IA via transporte stdio.

Configuração

Para Cursor IDE

Adicione isto à sua configuração MCP:

{
  "mcpServers": {
    "agile-luminary": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "env": {
        "LUMINARY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Para Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "agile-luminary": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "env": {
        "LUMINARY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Exemplos de Uso

Uma vez conectado, você pode usar linguagem natural no seu cliente de IA:

"Pesquise documentos sobre autenticação"
"Mostre minhas atribuições de trabalho atuais"
"Encontre trabalhos anteriores relacionados à funcionalidade de login do usuário"
"Que documentação existe sobre o sistema de pagamento?"
"Com base no meu trabalho atual, quais tarefas semelhantes foram concluídas antes?"

Endpoints da API

O servidor se conecta aos seguintes endpoints da API do Agile Luminary:

POST http://localhost:5006/bend/mcp/documents/search - Pesquisar documentos
GET http://localhost:5006/bend/mcp/userstories/current - Obter trabalho atual
POST http://localhost:5006/bend/mcp/userstories/search - Pesquisar trabalhos anteriores

Benefícios

Dados em Tempo Real: Sempre obtenha as informações mais recentes do projeto do seu sistema implantado
IA com Contexto: Seu assistente de IA tem contexto completo do status do seu projeto e documentação
Integração Perfeita: Funciona diretamente no seu ambiente de desenvolvimento
Seguro: O servidor lida com autenticação e comunicação com a API localmente
Capacidades de Busca: Encontre documentos relevantes e trabalhos anteriores através de busca inteligente

Autenticação

O servidor usa a variável de ambiente LUMINARY_API_KEY para autenticação. Esta chave é passada no cabeçalho Authorization para todas as requisições à API. Certifique-se de definir esta variável de ambiente antes de executar o servidor.

Tratamento de Erros

O servidor inclui tratamento abrangente de erros para:

Problemas de conectividade de rede
Falhas de autenticação na API
Respostas malformadas
Indisponibilidade do serviço
Chaves de API ausentes

Contribuição

Este servidor MCP foi projetado para funcionar especificamente com o sistema de gerenciamento de projetos Agile Luminary. Para modificações ou melhorias, garanta compatibilidade com os endpoints existentes da API.

Nota: Certifique-se de que sua conta Agile Luminary esteja criada e que você tenha sua chave de API de https://agileluminary.com antes de usar este servidor MCP. Defina a variável de ambiente LUMINARY_API_KEY com sua chave de API.

Agile Luminary

Documentação