Magic Meal Kits

What is Magic Meal Kits?

The Magic Meal Kits MCP server exposes the version of your Magic Meal Kits API so AI assistants can retrieve it through natural‑language requests.

How to use Magic Meal Kits?

1. Install the package (recommended via Smithery or npm).

   npx -y @smithery/cli install @pureugong/mmk-mcp --client claude
   # or globally
   npm install -g mmk-mcp
   

2. Create a .env file (or set environment variables) with MMK_API_KEY and MMK_API_BASE_URL.
3. Run the server (npm start or mmk-mcp).
4. Add the configuration to claude_desktop_config.json under mcpServers.
5. AI assistants can now call the magic_meal_kits_server_version tool to obtain the version.

Key Features

• Connects securely to your Magic Meal Kits API using API keys.
• Returns structured version information via a single tool (magic_meal_kits_server_version).
• Simple installation with npx and optional global npm install.
• Debug mode (npm run debug) for detailed console output.
• Compatible with Claude Desktop and any MCP client.

Use Cases

• Automated health‑checks in CI/CD pipelines to verify API version consistency.
• AI‑driven chatbots that need to report the current backend version to users.
• Monitoring tools that log version changes over time.
• Development environments where developers need quick access to the API version without manually querying the service.

FAQ

Q: Which version of the package supports tools? A: Versions 1.0.11 and later include tool support. Upgrade with npm install -g mmk-mcp@latest if needed.

Q: Do I need to set both MMK_API_KEY and MMK_API_BASE_URL? A: Yes. The key authenticates requests and the base URL points to your Magic Meal Kits deployment.

Q: Can I run the server without building it first? A: After installing globally, you can run mmk-mcp directly. For source builds, run npm run build then npm start.

Q: How do I test the server? A: Use the Model Context Protocol Inspector: npx @modelcontextprotocol/inspector stdio -c "node" -a "build/src/index.js".

Q: What environment does this run on? A: Any system with Node.js installed.

Magic Meal Kits MCP Server

A Model Context Protocol server for Magic Meal Kits that provides server version information as a tool for AI assistants.

How It Works

The MCP server:

• Connects to your Magic Meal Kits API
• Enables AI assistants to check the Magic Meal Kits server version
• Returns structured responses with version information
• Follows secure authentication practices using API keys

Benefits

• Check Magic Meal Kits server version programmatically through natural language requests
• Maintain a clean separation between your API backend and AI integration

Usage with Claude Desktop

Prerequisites

• NodeJS
• MCP Client (like Claude Desktop App)
• Magic Meal Kits API Key

Installation

Installing via Smithery

To install mmk-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @pureugong/mmk-mcp --client claude

Global Installation (Optional)

You can install the package globally using npm:

npm install -g mmk-mcp

Current version: 1.0.17

Claude Desktop Configuration

To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

{
    "mcpServers": {
        "magic-meal-kits": {
            "command": "npx",
            "args": ["-y", "mmk-mcp"],
            "env": {
                "MMK_API_KEY": "<your-api-key>",
                "MMK_API_BASE_URL": "<your-api-base-url>"
            }
        }
    }
}

• MMK_API_KEY - Your Magic Meal Kits API key
• MMK_API_BASE_URL - The base URL for your Magic Meal Kits API

Development

1. Clone this repository from https://github.com/pureugong/mmk-mcp
2. Create a .env file based on .env.example
3. Install dependencies: npm install
4. Build the project: npm run build
5. Run the server: npm start

Available Tools

Tool Name	Description	Parameters
magic_meal_kits_server_version	Check the Magic Meal Kits server version	No parameters required

Debugging

Running the MCP Server Directly

For debugging purposes, you can run the MCP server directly to see console output and any errors:

1. Create a .env file in the project root with all required environment variables:

MMK_API_KEY=your-api-key
MMK_API_BASE_URL=https://magic-meal-kits-isjxytikta-uw.a.run.app

2. Run the server directly:

# Using the enhanced debug script:
npm run debug

# Or if installed globally:
mmk-mcp

3. In another terminal, you can test the server using the MCP Inspector tool:

# Install the MCP Inspector
npm install -g @modelcontextprotocol/inspector

# Connect to your running MCP server
npx @modelcontextprotocol/inspector stdio -c "node" -a "build/src/index.js"

# Or if you've installed the inspector globally:
mcp-inspector stdio -c "node" -a "build/src/index.js"

This will open an interactive inspector where you can test the MCP tools and view responses from the server.

Troubleshooting

If you encounter issues with the MCP server, here are some common solutions:

Server Does Not Support Tools Error

If you see an error like Error: Server does not support tools (required for tools/call), make sure you're using version 1.0.11 or later.

To update to the latest version, run:

npm install -g mmk-mcp@latest