PureScript MCP Server

Ferramentas MCP do PureScript

Um servidor Model Context Protocol (MCP) que fornece ferramentas de desenvolvimento PureScript para assistentes de IA como o Claude.

Recursos

• Análise de Código: Analise e interprete a estrutura de código PureScript sem configuração pesada de IDE
• Integração com IDE PureScript: Inicie e gerencie servidores de IDE PureScript
• Informações de Tipo: Consulte tipos e encontre usos de código
• Grafos de Dependência: Gere representações visuais de dependências entre módulos
• Focado em IA: Construído especificamente para assistentes de IA que usam o Model Context Protocol

Instalação

Via npm (Recomendado)

npm install -g purescript-mcp-tools

A partir do código-fonte

# Clone this repository
git clone https://github.com/avi892nash/purescript-mcp-tools.git
cd purescript-mcp-tools

# Install dependencies
npm install

# Test that it works
npm test

Configuração

Para o Claude Desktop

1. Encontre o arquivo de configuração do Claude:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

2. Adicione esta configuração de servidor:

Se instalado via npm:

{
  "mcpServers": {
    "purescript-tools": {
      "command": "npx",
      "args": ["purescript-mcp-tools"]
    }
  }
}

Se instalado a partir do código-fonte:

{
  "mcpServers": {
    "purescript-tools": {
      "command": "node",
      "args": ["/FULL/PATH/TO/purescript-mcp-tools/index.js"]
    }
  }
}

3. Reinicie o Claude Desktop.

Para outros clientes MCP

Configure como um servidor MCP stdio:

• Comando: npx (ou node se a partir do código-fonte)
• Argumentos: ["purescript-mcp-tools"] (ou ["/full/path/to/index.js"] se a partir do código-fonte)
• Protocolo: stdio

Uso

Verificar a instalação

No seu cliente MCP, tente executar:

get_server_status

Você deve ver uma resposta mostrando que o servidor está em execução.

Ferramentas disponíveis

Este servidor MCP fornece as seguintes ferramentas:

Análise estática (sem necessidade de IDE)

• getModuleName - Extrai o nome do módulo de um arquivo PureScript
• getImports - Lista todas as importações de um módulo
• getAllFunctionNames - Obtém todas as definições de funções
• getExports - Lista valores exportados
• getFunctionSignature - Obtém a assinatura de tipo de uma função
• getDependencyGraph - Gera o grafo de dependências do módulo

Integração com IDE PureScript

• start_purs_ide_server - Inicia um servidor de IDE PureScript
• stop_purs_ide_server - Para o servidor de IDE
• pursIdeLoad - Carrega módulos no IDE
• pursIdeType - Obtém informações de tipo
• pursIdeComplete - Obtém sugestões de conclusão
• pursIdeUsages - Encontra onde um símbolo é usado
• pursIdeCaseSplit - Gera divisões de caso
• pursIdeAddClause - Adiciona cláusula de função
• pursIdeImport - Adiciona importações

Fluxo de trabalho básico

1. Verifique o status: get_server_status
2. Para análise simples: Use as ferramentas de análise estática diretamente
3. Para recursos avançados:
   • start_purs_ide_server com o caminho do seu projeto
   • pursIdeLoad para carregar módulos
   • Use pursIdeType, pursIdeUsages, etc.

Requisitos

• Node.js >= 14.0.0
• Compilador PureScript (purs) - Necessário apenas se você usar recursos de IDE
• Seu projeto PureScript - Com saída compilada para recursos de IDE

Solução de problemas

O servidor não inicia: Verifique se o Node.js está instalado e se as dependências estão instaladas (npm install)

Ferramentas não funcionam: Execute get_server_status para ver o que está disponível

Erros de caminho: Certifique-se de usar caminhos absolutos na sua configuração MCP

Vários servidores: Execute apenas um servidor de IDE PureScript por vez para evitar conflitos de porta

Contribuindo

Contribuições são bem-vindas! Consulte CONTRIBUTING.md para diretrizes.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Suporte

• Problemas: GitHub Issues
• Discussões: GitHub Discussions

Agradecimentos

Este servidor implementa o Model Context Protocol e fornece assistência abrangente de desenvolvimento PureScript para ferramentas de IA.