mq-mcp 0.1.10 - Docs.rs

Model Context Protocol (MCP) server implementation for mq. This crate provides an MCP server that allows AI assistants to process Markdown and HTML content using mq's query language.

Installation

You can install mq-mcp using the installation script:

curl -fsSL https://raw.githubusercontent.com/harehare/mq-mcp/main/bin/install.sh | bash

Or clone this repository and run the install script:

git clone https://github.com/harehare/mq-mcp.git
cd mq-mcp
./bin/install.sh

The script will:

Install the mq binary to ~/.mq/bin
Add ~/.mq/bin to your PATH (if not already present)
Support macOS, Linux, and Windows
Verify checksums for security

After installation, restart your terminal or run:

source ~/.zshrc  # or ~/.bashrc for bash users

Implementation

The server implements four MCP tools:

html_to_markdown: Converts HTML to Markdown and executes mq queries
extract_markdown: Executes mq queries on Markdown content
available_functions: Returns available functions for mq queries
available_selectors: Returns available selectors for mq queries

Tool Parameters

html_to_markdown

html (string): HTML content to process
query (optional string): mq query to execute

extract_markdown

markdown (string): Markdown content to process
query (string): mq query to execute

available_functions

No parameters. Returns JSON with function names, descriptions, parameters, and example queries.

available_selectors

No parameters. Returns JSON with selector names, descriptions, and parameters.

Configuration

Claude Desktop

Using mq-mcp binary directly

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mq-mcp": {
      "command": "/Users/YOUR_USERNAME/.mq/bin/mq-mcp",
      "args": []
    }
  }
}

Or simply use mq-mcp if ~/.mq/bin is in your PATH:

{
  "mcpServers": {
    "mq-mcp": {
      "command": "mq-mcp",
      "args": []
    }
  }
}

Using mq command

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mq-mcp": {
      "command": "/Users/YOUR_USERNAME/.mq/bin/mq",
      "args": ["mcp"]
    }
  }
}

Or simply use mq if ~/.mq/bin is in your PATH:

{
  "mcpServers": {
    "mq-mcp": {
      "command": "mq",
      "args": ["mcp"]
    }
  }
}

VS Code with MCP Extension

Using mq-mcp binary directly

Add to .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "mq-mcp": {
        "type": "stdio",
        "command": "mq-mcp",
        "args": []
      }
    }
  }
}

Using mq command

Add to .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "mq-mcp": {
        "type": "stdio",
        "command": "mq",
        "args": ["mcp"]
      }
    }
  }
}

License

This project is licensed under the MIT License