Purescript MCP Tools

🚀 PureScript MCP Server

This is a Model Context Protocol (MCP) server that offers PureScript development tools for AI assistants such as Claude, enabling seamless integration and efficient development.

🚀 Quick Start

📦 Installation

Step 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

Step 2: Configure Your MCP Client

For Claude Desktop

1. Locate your Claude config file:

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

2. Add the following server configuration:

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

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

4. Restart Claude Desktop.

For Other MCP Clients

Configure it as a stdio MCP server:

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

Step 3: Verify Installation

In your MCP client, try running the following command:

get_server_status

You should receive a response indicating that the server is running.

✨ Features

This MCP server empowers AI assistants with the following capabilities:

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

💻 Usage Examples

Basic Usage

1. Check status: get_server_status
2. For simple analysis: Directly use commands like getModuleName, getImports, etc.

Advanced Usage

1. Start the IDE server: start_purs_ide_server with your project path.
2. Load modules: pursIdeLoad to load modules.
3. Utilize advanced commands: Use pursIdeType, pursIdeUsages, etc.

📚 Documentation

Requirements

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

Troubleshooting

• Server won't start: Ensure that Node.js is installed and you have run npm install.
• Tools not working: First run get_server_status to check what's available.
• Path errors: Make sure you have used the full absolute path in your MCP configuration.
• Multiple servers: Run only one PureScript IDE server at a time to avoid conflicts.

Support

This server offers comprehensive PureScript development assistance to AI tools via the standardized MCP protocol.