mcp-mcpmarket

AI Agent Auto-Install: Point your agent to this repo and say "install mcp-mcpmarket" — it will read this README, detect your MCP client (Kilo/Claude Desktop), and configure itself automatically.

Features

• Search MCP servers by keyword
• Detail view with GitHub README scraping (language, license, real install commands, config JSON, env vars, tools)
• Trending servers from the leaderboard
• Browse by category
• Agent Skills search
• One-click install to Kilo config

Quick Install (AI Agent)

If you're an AI agent installing this for a user:

# Detect MCP client and auto-configure
git clone https://github.com/Xzeroone/mcp-mcpmarket.git /tmp/mcp-mcpmarket
cd /tmp/mcp-mcpmarket

# Check if Kilo config exists
if [ -f ~/.config/kilo/kilo.jsonc ]; then
  # Add to Kilo config (local build)
  npm install && npm run build
  echo '{
    "mcp": {
      "mcpmarket": {
        "type": "local",
        "command": ["node", "'$(pwd)'/dist/index.js"],
        "enabled": true
      }
    }
  }' >> ~/.config/kilo/kilo.jsonc
fi

Manual Install

Option 1: npx (No build required)

{
  "mcpServers": {
    "mcpmarket": {
      "command": "npx",
      "args": ["-y", "mcp-mcpmarket"]
    }
  }
}

Option 2: Local Build (Recommended for reliability)

git clone https://github.com/Xzeroone/mcp-mcpmarket.git
cd mcp-mcpmarket
npm install
npm run build

Then configure your MCP client:

Kilo (Recommended)

// ~/.config/kilo/kilo.jsonc
{
  "mcp": {
    "mcpmarket": {
      "type": "local",
      "command": ["node", "/path/to/mcp-mcpmarket/dist/index.js"],
      "enabled": true
    }
  }
}

Claude Desktop

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcpmarket": {
      "command": "node",
      "args": ["/path/to/mcp-mcpmarket/dist/index.js"]
    }
  }
}

Tools

Tool	Description
mcpmarket_search	Search MCP servers by keyword
mcpmarket_detail	Full details + GitHub README scrape
mcpmarket_trending	Top/trending servers
mcpmarket_categories	List all categories
mcpmarket_browse	Browse servers in a category
mcpmarket_skills	Search agent skills
mcpmarket_install	Install an MCP server to Kilo config (by slug or manual command)

How It Works

1. Scrapes mcpmarket.com pages and extracts structured data from JSON-LD tags
2. For detail views, fetches the GitHub README from raw.githubusercontent.com
3. Parses the README to detect: language, license, install commands, config JSON blocks, env vars, and tool names
4. The mcpmarket_install tool writes directly to your Kilo kilo.jsonc config

Install Workflow

The mcpmarket_install tool supports two modes:

One-click install (recommended)

mcpmarket_install({ slug: "firecrawl" })

Automatically fetches the server details and extracts the correct install command from GitHub.

Manual install

mcpmarket_install({ name: "my-server", command: ["npx", "-y", "@some/mcp-server"] })

Use when you already know the exact command.

Parameters

Parameter	Required	Description
slug	Yes (or command)	Server slug from mcpmarket.com. Auto-fetches install command.
name	No	Config entry name. Defaults to server slug.
command	Yes (or slug)	Manual command array if slug not provided.
environment	No	Environment variables to set.
global	No	Install to global config (default: true).

Development

npm install
npm run build
node dist/index.js

License

MIT