PureScript MCP Server

An MCP server offering PureScript development tools for AI assistants. Requires Node.js and the PureScript compiler for full functionality.

View on GitHub →

PureScript MCP Server

A Model Context Protocol (MCP) server that provides PureScript development tools for AI assistants like Claude.

Quick Install

1. Download and Setup

# Clone this repository
git clone <repository-url>
cd purescript-mcp-server

# Install dependencies
npm install

# Test that it works
node index.js
# Press Ctrl+C to stop

2. Configure Your MCP Client

For Claude Desktop

  1. Find your Claude config file:

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

  2. Add this server configuration:

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

  1. Important: Replace /FULL/PATH/TO/ with the actual absolute path to where you cloned this repository.

  2. Restart Claude Desktop.

For Other MCP Clients

Configure as a stdio MCP server:

  • Command: node
  • Arguments: ["/full/path/to/index.js"]
  • Protocol: stdio

3. Verify Installation

In your MCP client, try running:

get_server_status

You should see a response showing the server is running.

What This Server Provides

This MCP server gives AI assistants the ability to:

  • Analyze PureScript code without heavy IDE setup
  • Start/manage PureScript IDE servers for advanced features
  • Look up types and find code usages
  • Generate dependency graphs
  • Parse code structure (modules, imports, functions)

Basic Usage Flow

  1. Check status: get_server_status
  2. For simple analysis: Use getModuleName, getImports, etc. directly
  3. For advanced features:
    • start_purs_ide_server with your project path
    • pursIdeLoad to load modules
    • Use pursIdeType, pursIdeUsages, etc.

Requirements

  • Node.js (any recent version)
  • PureScript compiler (purs) if using IDE features
  • Your PureScript project with compiled output

Troubleshooting

Server won't start: Check that Node.js is installed and you ran npm install

Tools not working: Run get_server_status first to see what's available

Path errors: Make sure you used the full absolute path in your MCP configuration

Multiple servers: Only run one PureScript IDE server at a time to avoid conflicts

Support

This server provides comprehensive PureScript development assistance to AI tools through the standardized MCP protocol.

Related Servers