Developer MCP Server

Um sistema de gerenciamento de contexto projetado para equipes de desenvolvimento de software com armazenamento de dados personalizável.

Documentação

Developer MCP Server

Sistema de gerenciamento de contexto projetado para equipes de desenvolvimento de software. O Developer MCP Server mantém contexto persistente entre sessões de codificação, garantindo que você nunca perca o controle da estrutura, dependências e progresso do projeto.

Developer Server MCP server

Recursos

  • Contexto de Desenvolvimento Persistente: Retome exatamente de onde parou na sua última sessão, com contexto completo sobre os componentes, problemas e tarefas em que estava trabalhando.

  • Gerenciamento de Sessões: Inicie novas sessões de desenvolvimento e registre suas conquistas, atualizações de tarefas e mudanças de status do projeto ao finalizar, criando um registro persistente das suas atividades de desenvolvimento.

  • Rastreamento de Dependências: Entenda como componentes, recursos e tecnologias se relacionam entre si com um modelo abrangente de dependências.

  • Insights de Status do Projeto: Obtenha visibilidade imediata do progresso do projeto, incluindo status de componentes, recursos, problemas e marcos.

  • Recuperação de Contexto de Componentes: Entenda o propósito, detalhes de implementação, dependências e problemas relacionados de qualquer componente rapidamente.

  • Histórico de Decisões: Acompanhe por que decisões arquiteturais e de implementação foram tomadas, quando e por quem — sem mais adivinhações sobre por que algo foi construído de determinada forma.

  • Acompanhamento de Progresso de Marcos: Monitore o progresso em direção aos marcos do projeto e identifique possíveis gargalos antes que eles comprometam seu cronograma.

  • Descoberta de Entidades Relacionadas: Encontre rapidamente todas as entidades relacionadas a qualquer componente, recurso ou tarefa para entender seu contexto completo.

Entidades

O Developer MCP Server reconhece os seguintes tipos de entidades no seu contexto de desenvolvimento de software:

  • Project: Projeto ou produto de software geral
  • Component: Módulo, serviço, pacote ou unidade lógica dentro de um projeto
  • Feature: Funcionalidade específica em desenvolvimento
  • Issue: Bug, problema ou defeito a ser resolvido
  • Task: Item de trabalho ou atividade necessária para o desenvolvimento
  • Developer: Membro da equipe que trabalha no projeto
  • Technology: Linguagem de programação, framework, biblioteca ou ferramenta
  • Decision: Decisão técnica ou arquitetural importante
  • Milestone: Prazo ou fase chave do projeto
  • Environment: Ambiente de desenvolvimento, staging ou produção
  • Documentation: Recurso de documentação do projeto
  • Requirement: Requisito ou especificação do projeto

Relacionamentos

O Developer MCP Server modela os seguintes relacionamentos entre entidades, refletindo a dinâmica real do desenvolvimento de software:

  • depends_on: A Entidade A requer a Entidade B para funcionar
  • implements: Componente implementa um recurso
  • assigned_to: Tarefa é atribuída a um desenvolvedor
  • blocked_by: Tarefa está bloqueada por um problema
  • uses: Componente usa uma tecnologia
  • part_of: Componente faz parte de um projeto
  • contains: Projeto contém um componente
  • works_on: Desenvolvedor trabalha em um projeto/componente
  • related_to: Relacionamento geral entre entidades
  • affects: Problema afeta um componente
  • resolves: Tarefa resolve um problema
  • created_by: Entidade foi criada por um desenvolvedor
  • documented_in: Componente é documentado na documentação
  • decided_in: Decisão foi tomada em uma reunião
  • required_by: Recurso é exigido por um requisito
  • has_status: Entidade possui um status específico
  • depends_on_milestone: Tarefa depende de atingir um marco
  • precedes: Tarefa precede outra tarefa (sequenciamento)
  • reviews: Desenvolvedor revisa um componente
  • tested_in: Componente é testado em um ambiente

Variáveis de Ambiente

O Developer MCP Server suporta as seguintes variáveis de ambiente para personalizar onde os dados são armazenados:

  • MEMORY_FILE_PATH: Caminho onde os dados do grafo de conhecimento serão armazenados

    • Pode ser absoluto ou relativo (caminhos relativos usam o diretório de trabalho atual)
    • Padrão: ./developer/memory.json
  • SESSIONS_FILE_PATH: Caminho onde os dados de sessão serão armazenados

    • Pode ser absoluto ou relativo (caminhos relativos usam o diretório de trabalho atual)
    • Padrão: ./developer/sessions.json

Exemplo de uso:

# Store data in the current directory
MEMORY_FILE_PATH="./dev-memory.json" SESSIONS_FILE_PATH="./dev-sessions.json" npx github:tejpalvirk/contextmanager-developer

# Store data in a specific location (absolute path)
MEMORY_FILE_PATH="/path/to/data/developer-memory.json" npx github:tejpalvirk/contextmanager-developer

# Store data in user's home directory
MEMORY_FILE_PATH="$HOME/contextmanager/developer-memory.json" npx github:tejpalvirk/contextmanager-developer

Ferramentas Disponíveis

O Developer MCP Server fornece as seguintes ferramentas:

  • startsession: Inicia uma nova sessão de desenvolvimento e fornece informações sobre sessões recentes, projetos ativos, tarefas de alta prioridade e marcos futuros.

  • loadcontext: Carrega contexto detalhado para uma entidade (projeto, componente, recurso, tarefa, etc.) e registra esse carregamento de contexto como parte da sessão atual.

  • endsession: Realiza uma análise estruturada da sessão de desenvolvimento em múltiplas etapas (resumo, conquistas, atualizações de tarefas, novas tarefas, status do projeto) e registra essas informações no grafo de conhecimento persistente.

  • buildcontext: Cria novas entidades, relações ou observações no grafo de conhecimento.

  • deletecontext: Remove entidades, relações ou observações do grafo de conhecimento.

  • advancedcontext: Recupera informações do grafo de conhecimento com diferentes tipos de consulta (grafo, busca, nós, relacionados, decisões, marcos).

Prompts

Aqui estão alguns exemplos de prompts para usar com o Developer MCP Server:

Iniciando uma Sessão

"Start a new development session for me."

Carregando Contexto

"Show me the current status of the AuthService project."
"Load the context for the UserProfile component."
"What are the open issues affecting the Payment feature?"
"Show me details about the upcoming Q2 Release milestone."

Registrando Progresso da Sessão

"End my development session. I've been working on AuthService for 3 hours and completed user authentication flow implementation."
"Record my achievements for today: implemented password reset feature and fixed login redirect bug."
"Update the status of these tasks: Login Form is complete, User Registration is in progress."
"Create new tasks for the next sprint: Implement MFA, Add social login options."

Gerenciamento do Grafo de Conhecimento

"Create a new feature called 'BillingSystem' in the ProjectX project."
"Create a relationship showing that PaymentComponent implements BillingSystem feature."
"Show me all components that depend on the DatabaseService."
"What decisions have been made about the authentication approach for ProjectX?"

Uso

O Developer MCP Server se destaca em cenários como:

Continuidade de Contexto

"Let me see the component I was working on yesterday and all its dependencies."

O servidor recupera seus componentes acessados mais recentemente, juntamente com suas dependências, problemas e tarefas relacionadas, permitindo que você retome o trabalho instantaneamente sem gastar tempo reconstruindo o contexto.

Integração de Novos Membros da Equipe

"Give me an overview of Project X's architecture and component structure."

Novos desenvolvedores podem entender rapidamente a estrutura do projeto, os componentes principais e seus relacionamentos — reduzindo drasticamente o tempo necessário para se tornarem produtivos em uma nova base de código.

Registro de Sessão

"End my development session and record what I accomplished."

O servidor guia você por um processo estruturado para documentar suas conquistas, atualizações de tarefas e mudanças de status do projeto, preservando esse contexto para sessões futuras e membros da equipe.

Contexto de Decisões Arquiteturais

"Why was GraphQL chosen over REST for the API layer?"

O servidor recupera a entidade de decisão juntamente com reuniões relacionadas, desenvolvedores envolvidos e o contexto em que a decisão foi tomada — preservando conhecimento organizacional que de outra forma seria perdido.

Análise de Dependências

"What would be affected if we modify the authentication service?"

Antes de fazer alterações, os desenvolvedores podem entender todos os componentes, recursos e tarefas que dependem de um componente específico, reduzindo o risco de quebras inesperadas.

Acompanhamento de Progresso do Projeto

"What's our progress toward the Q2 release milestone?"

Líderes de projeto podem ver instantaneamente o status de todas as tarefas e recursos associados a um marco, identificando itens em risco antes que eles comprometam o cronograma.

Configuração

Uso com Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

Instalar do GitHub e executar com npx

{
  "mcpServers": {
    "developer": {
      "command": "npx",
      "args": [
        "-y",
        "github:tejpalvirk/developer"
      ]
    }
  }
}

Instalar globalmente e executar diretamente

Primeiro, instale o pacote globalmente:

npm install -g github:tejpalvirk/contextmanager/developer

Em seguida, configure o Claude Desktop:

{
  "mcpServers": {
    "developer": {
      "command": "contextmanager-developer"
    }
  }
}

docker

{
  "mcpServers": {
    "developer": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/developer"
      ]
    }
  }
}

Compilação

A partir do Código Fonte

# Clone the repository
git clone https://github.com/tejpalvirk/contextmanager.git
cd contextmanager

# Install dependencies
npm install

# Build the server
npm run build

# Run the server
cd developer
node developer_index.js

Docker:

docker build -t mcp/developer -f developer/Dockerfile .

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.