# 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:

```bash
# 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)

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

### Option 2: Local Build (Recommended for reliability)

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

Then configure your MCP client:

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

**Claude Desktop**
```json
// ~/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](https://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

```bash
npm install
npm run build
node dist/index.js
```

## License

MIT