Zipline Mcp

by dorogoy

2.7k downloads Not rated yet

About

# Zipline MCP Server An MCP (Model Context Protocol) server that allows you to upload files to a Zipline-compatible host. This server provides tools for uploading files, validating them, and generating upload commands. ## Features - Upload files to a Zipline instance - Validate files before uploading - Preview upload…

Explore

- Upload files to a Zipline instance
- Validate files before uploading
- Preview upload commands
- Get only the download URL after upload
- List and search user files stored on the Zipline server
- Support for multiple file types, including:
- Text/code: txt, md, gpx, html, json, xml, csv, js, css, py, sh, yaml, yml
- Images: png, jpg, jpeg, gif, webp, svg, bmp, tiff, ico, heic, avif

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Zipline Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Node.js (v18 or higher)
- npm or yarn

To install the server globally so you can use it with npx:

npm install -g zipline-mcp

To install the server as a dependency in your project:

npm install zipline-mcp

To use this server with an MCP client (like Claude Desktop), you need to add it to your client's configuration file.

Add this minimal configuration to your MCP client (e.g., Claude Desktop):


- Symptom: "Invalid authorization token" errors
- Solutions:
  - Verify token validity
  - Check for typos in the ZIPLINE_TOKEN value
  - Ensure token is passed via environment variable

upload_file_to_zipline(filePath: "document.txt", format: "RANDOM-WORDS")

To check for lint errors:

npm run lint

To automatically fix fixable issues:

npm run lint:fix

Or use the Makefile:

make lint

This server provides the following tools:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "zipline mcp": {
            "zipline": {
                "command": "npx",
                "args": [
                    "-y",
                    "zipline-mcp"
                ],
                "environment": {
                    "ZIPLINE_TOKEN": "<YOUR-TOKEN>",
                    "ZIPLINE_ENDPOINT": "http://localhost:3000"
                }
            }
        }
    }
}

McpServers

{
    "zipline": {
        "command": "npx",
        "args": [
            "-y",
            "zipline-mcp"
        ],
        "environment": {
            "ZIPLINE_TOKEN": "<YOUR-TOKEN>",
            "ZIPLINE_ENDPOINT": "http://localhost:3000"
        }
    }
}

An MCP (Model Context Protocol) server that allows you to upload files to a Zipline-compatible host. This server provides tools for uploading files, validating them, and generating upload commands.

Features

- Upload files to a Zipline instance
- Validate files before uploading
- Preview upload commands
- Get only the download URL after upload
- List and search user files stored on the Zipline server
- Support for multiple file types, including:
- Text/code: txt, md, gpx, html, json, xml, csv, js, css, py, sh, yaml, yml
- Images: png, jpg, jpeg, gif, webp, svg, bmp, tiff, ico, heic, avif

Installation

Global Installation

To install the server globally so you can use it with npx:

npm install -g zipline-mcp

Local Installation

To install the server as a dependency in your project:

npm install zipline-mcp

Usage

Using with npx

If you installed the server globally, you can run it directly:

npx zipline-mcp

Adding to MCP Client Configuration

To use this server with an MCP client (like Claude Desktop), you need to add it to your client's configuration file.

MCP-Zipline Integration Guide

Quickstart Configuration

Add this minimal configuration to your MCP client (e.g., Claude Desktop):

```yaml

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.