This MCP server provides AI assistants with comprehensive PureScript development tools for code analysis, type checking, and project management.
Lightweight Code Analysis (No IDE Server Required):
Extract module names, imports, and function names from PureScript code
Parse and filter top-level declarations (functions, data types, type classes) with detailed information
Analyze function structure including where-clause bindings
Quick code inspection without full IDE setup
IDE Server Management:
Start and stop PureScript IDE servers with automatic port selection and conflict prevention
Monitor server status and check running processes
Load modules to initialize the IDE server with project context
Reset server state or gracefully quit IDE processes
Advanced Development Features (Requires IDE Server):
Look up type signatures for identifiers
Find all usages of functions, types, or values across the project
Quickly rebuild individual modules and check for errors
Generate comprehensive dependency graphs showing relationships between modules, functions, and types
List available modules and browse project structure
Get completion information and verify working directory
Testing and Diagnostics:
Echo test to verify server connectivity
Status checks to monitor available features and running processes
Serves as the runtime environment for the MCP server, allowing it to provide PureScript development tools and IDE features.
Enables advanced code analysis features including starting/managing PureScript IDE servers, looking up types, finding code usages, generating dependency graphs, and parsing module structure (modules, imports, functions).
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
2. Configure Your MCP Client
For Claude Desktop
Find your Claude config file:
Mac:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.json
Add this server configuration:
Important: Replace
/FULL/PATH/TO/with the actual absolute path to where you cloned this repository.Restart Claude Desktop.
For Other MCP Clients
Configure as a stdio MCP server:
Command:
nodeArguments:
["/full/path/to/index.js"]Protocol: stdio
3. Verify Installation
In your MCP client, try running:
You should see a response showing the server is running.
Related MCP server: Appwrite MCP Server
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
Check status:
get_server_statusFor simple analysis: Use
getModuleName,getImports, etc. directlyFor advanced features:
start_purs_ide_serverwith your project pathpursIdeLoadto load modulesUse
pursIdeType,pursIdeUsages, etc.
Requirements
Node.js (any recent version)
PureScript compiler (
purs) if using IDE featuresYour 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.