Pylpex MCP

This is a MCP server for Pylpex interpreter.

Installation

Assuming you are using Claude Desktop and have uv installed, follow these instructions to set up the Pylpex MCP server:

Clone the repository:

git clone https://github.com/Golto/pylpex-mcp.git cd pylpex-mcp

Install dependencies:

uv sync

This command reads the pyproject.toml file and installs all the required dependencies.

Configure your Claude Desktop settings to use this MCP server:

Go to your Claude Desktop settings, then to the Developer Settings tab, click on "Edit config" and add the following configuration to your claude_desktop_config.json:

{ "mcpServers": { "Pylpex": { "command": "uv", "args": [ "--directory", "$ABSOLUTE/PATH/TO/THE/PROJECT/pylpex-mcp", "run", "mcp", "run", "main.py" ] } } }

You may want to replace uv with the absolute path to the uv executable. To find uv location, use which uv on Linux/MacOS or where uv on Windows. Also, replace $ABSOLUTE/PATH/TO/THE/PROJECT/pylpex-mcp with the absolute path to the project directory. --directory argument is required for uv to find the project with dependencies.

Note: Running uv run mcp install main.py will install the MCP server in your Claude Desktop settings directly. But it may not work because of the --directory argument missing.

Close and reopen your Claude Desktop application to apply the changes.
Verify that the Pylpex server is running by checking the status in the Developer Settings tab.

You should see the Pylpex tools available in your Claude Desktop interface.

Tools

At this point, you should have access to the following tools:

run: Execute Pylpex code and return the result.
tokenize: Convert Pylpex code into tokens for analysis. Use the Lexer component of the Pylpex interpreter.
get_variables: Get all variables in the current interpreter state.
reset: Reset the interpreter state.

Resources

get_documentation: Get the documentation of the Pylpex language. It gives you the syntax and the available functions.
get_examples: Get examples of Pylpex code as code snippets.