PureScript MCP Server

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

- Code Analysis: Parse and analyze PureScript code structure without heavy IDE setup
- PureScript IDE Integration: Start and manage PureScript IDE servers
- Type Information: Look up types and find code usages
- Dependency Graphs: Generate visual representations of module dependencies
- AI-First: Built specifically for AI assistants using the Model Context Protocol

# 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

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

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

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

- Command:npx(ornodeif from source)
- Arguments:["purescript-mcp-tools"](or["/full/path/to/index.js"]if from source)
- Protocol: stdio

You should see a response showing the server is running.

This MCP server provides the following tools:

- getModuleName- Extract module name from PureScript file
- getImports- List all imports from a module
- getAllFunctionNames- Get all function definitions
- getExports- List exported values
- getFunctionSignature- Get type signature for a function
- getDependencyGraph- Generate module dependency graph

- start_purs_ide_server- Start a PureScript IDE server
- stop_purs_ide_server- Stop the IDE server
- pursIdeLoad- Load modules into IDE
- pursIdeType- Get type information
- pursIdeComplete- Get completion suggestions
- pursIdeUsages- Find where a symbol is used
- pursIdeCaseSplit- Generate case splits
- pursIdeAddClause- Add function clause
- pursIdeImport- Add imports
- Check status:get_server_status
- For simple analysis: Use static analysis tools directly
- For advanced features:

- start_purs_ide_serverwith your project path
- pursIdeLoadto load modules
- UsepursIdeType,pursIdeUsages, etc.

- Node.js>= 14.0.0
- PureScript compiler(purs) - Required only if using IDE features
- Your PureScript project- With compiled output for IDE features

Server won't start: Check that Node.js is installed and dependencies are installed (npm install)

Tools not working: Runget_server_statusto see what's available

Path errors: Ensure you use absolute paths in your MCP configuration

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

Contributions are welcome! Please seeCONTRIBUTING.mdfor guidelines.

This project is licensed under the MIT License - see theLICENSEfile for details.

- Issues:GitHub Issues
- Discussions:GitHub Discussions

This server implements theModel Context Protocoland provides comprehensive PureScript development assistance to AI tools.

Execute any LLM-generated code in the YepCode secure and scalable sandbox environment and create your own MCP tools using JavaScript or Python, with full support for NPM and PyPI packages