Luckycola Mcp

Name: Luckycola Mcp
Author: mingle98

@mingle98

Repository

About Luckycola Mcp

基于LuckyCola开放能力的MCP（Model Context Protocol）服务。支持图片合规性检查、文件操作、图片压缩、图片OCR等丰富功能.

#luckycola-mcp #check-image #get-food-menu #image-check #image-ocr #file-operation #image-compress

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "luckycola-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "luckycola-mcp"
      ],
      "env": {
        "LUCKYCOLA_OPEN_KEY": "你的APPKey",
        "LUCKYCOLA_OPEN_UID": "你的UID",
        "MCP_FILE_PATH": "希望进行文件/图片操作的目录路径,例如: /Users/yourname/Desktop/testDir"
      }
    }
  }
}

Tools

检查在线图片内容是否合规

获取菜品的菜谱(制作方法)

Overview

What is Luckycola Mcp?

Luckycola Mcp is a Model Context Protocol (MCP) server built on LuckyCola’s open capabilities. It integrates with LuckyCola’s API to provide tools for image compliance checking, recipe retrieval, file operations (delete, rename, read, write, list, JSON/Excel conversion), image compression, and OCR. It is designed for developers who want to use LuckyCola services through standard MCP clients like Claude Desktop or Cursor.

How to use Luckycola Mcp?

Install dependencies with yarn install, then build with yarn build. Set three environment variables: LUCKYCOLA_OPEN_KEY (your LuckyCola APPKey), LUCKYCOLA_OPEN_UID (your LuckyCola UID), and MCP_FILE_PATH (the directory where file operations will occur). Run directly with node build/index.js or configure it as an MCP server in your client’s JSON settings (npx or local path). Node.js v21.0.0+ is required.

Key features of Luckycola Mcp

Standardized MCP interface compatible with various MCP clients
Environment variable configuration for security
Online image compliance checking for content safety
Recipe query tool for dish preparation methods
Rich file operations: delete, rename, read, write, list
JSON to Excel and Excel to JSON conversion
Image compression (jpg/png/gif) and OCR (jpg/png ≤2MB)

Use cases of Luckycola Mcp

Automate image moderation in a content‑review workflow
Retrieve cooking recipes programmatically via natural language
Manage files (delete, rename, read/write) in a specified directory
Convert JSON data to Excel spreadsheets or vice versa
Extract text from images using OCR, or compress images for storage

FAQ from Luckycola Mcp

What environment variables are required?

You must set LUCKYCOLA_OPEN_KEY, LUCKYCOLA_OPEN_UID, and MCP_FILE_PATH. The API key and UID are obtained from your LuckyCola account’s user center. The MCP_FILE_PATH restricts all file operations to that directory.

What Node.js version is needed?

Node.js version 21.0.0 or above is required.

How do I get API credentials?

Visit the LuckyCola official website, log in, and go to the user center to get your APPKey and UID. Ensure your account has the necessary API permissions and quota.

What file operations are supported?

The server supports delete, rename, read, write, list, JSON‑to‑Excel, Excel‑to‑JSON, image compression, and OCR. All operations are limited to the MCP_FILE_PATH directory.

Are there any known limits or troubleshooting?

Image OCR only supports jpg/png files ≤2MB. Image compression supports jpg/png/gif. If you encounter npx connection issues, run npx -y luckycola-mcp directly in the console to see error details.