# JieBang Tools MCP Server

🛠️ **29 free tools** via MCP (Model Context Protocol). No API key required.

[![Smithery](https://img.shields.io/badge/Smithery-Available-green)](https://smithery.ai/servers/ajie-jiebang/jiebang-tools)
[![MCP](https://img.shields.io/badge/MCP-2.0-blue)](https://modelcontextprotocol.io)

## Quick Setup

### Cursor / Claude Desktop / Windsurf
Add to your MCP config file:
```json
{
  "mcpServers": {
    "jiebang-tools": {
      "url": "https://www.jiebang.site/mcp",
      "transport": "streamable-http"
    }
  }
}
```

### Smithery CLI
```bash
npx -y @smithery/cli install ajie-jiebang/jiebang-tools --client claude
```

### Direct Test
```bash
curl -X POST https://www.jiebang.site/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## Available Tools (29)

### 📝 Text Processing
| Tool | Description |
|------|-------------|
| `json_yaml_convert` | Convert between JSON and YAML |
| `xml_format` | Beautify, minify, or validate XML |
| `sql_format` | Beautify, minify, or uppercase SQL |
| `cron_parse` | Parse cron expressions with next run times |
| `base_convert` | Convert between decimal/binary/octal/hex |
| `html_entity` | Encode or decode HTML entities |
| `timezone_convert` | Convert time between time zones |

### 🤖 AI-Powered Tools
| Tool | Description |
|------|-------------|
| `ai_text_generate` | AI copywriting, naming, slogans, titles, praise, couplets |
| `text_humanize` | Rewrite AI text to sound human (降AI率) |
| `keyword_extract` | Extract keywords with search intent classification |
| `text_rewrite` | Rewrite text in standard/creative/academic/casual styles |
| `text_summarize` | Summarize text (short/medium/long) |

### 🔍 SEO Tools
| Tool | Description |
|------|-------------|
| `seo_title_generate` | Generate SEO-optimized article titles |
| `meta_desc_generate` | Generate meta descriptions (120-160 chars) |
| `meta_extract` | Extract SEO meta tags from any URL |
| `seo_check` | SEO health check with score |

### 🛠️ Utilities
| Tool | Description |
|------|-------------|
| `qrcode_generate` | Generate QR codes (SVG) |
| `url_shorten` | Create short links with click tracking |
| `image_convert` | Convert image formats (WebP/AVIF/PNG/JPEG) |

### ⏰ Cron Task Manager
| Tool | Description |
|------|-------------|
| `cron_task_create` | Create scheduled tasks with cron expressions |
| `cron_task_list` | List tasks (filter by due/tag) |
| `cron_task_done` | Mark task complete or failed |
| `cron_task_logs` | View execution history |
| `cron_task_templates` | Preset task templates |

### 📊 File Processing
| Tool | Description |
|------|-------------|
| `file_parse` | Parse CSV/TSV/JSON/XML to structured data |
| `file_generate` | Generate CSV/TSV/JSON from data |
| `file_analyze` | Analyze tabular data with stats |

### 💡 Ideas Board
| Tool | Description |
|------|-------------|
| `idea_submit` | Submit feature requests |
| `idea_list` | Browse and filter ideas |

## Why JieBang?

- 🆓 **Free** — No API key, no registration
- ⚡ **Fast** — ~10ms response time (built-in tools), AI tools ~2-5s
- 🔓 **Open** — REST API + MCP dual protocol
- 🌐 **29 tools** — Text, AI, SEO, images, files, cron tasks
- 🇨🇳 **Bilingual** — Chinese and English support

## REST API

All tools are also available as REST API endpoints:

```bash
# Generate QR code
curl -X POST https://www.jiebang.site/api/qrcode \
  -d '{"content":"https://example.com","format":"svg"}'

# SEO title generation
curl -X POST https://www.jiebang.site/api/seo-title \
  -d '{"keyword":"free PDF converter","count":5,"lang":"en"}'

# Text humanizer
curl -X POST https://www.jiebang.site/api/humanizer \
  -d '{"text":"AI-generated text here","lang":"en"}'

# Shorten URL
curl -X POST https://www.jiebang.site/api/shorten \
  -d '{"url":"https://example.com/very/long/url"}'
```

Full API docs: https://www.jiebang.site/api-docs

## Links

- 🌐 Website: https://www.jiebang.site
- 📦 GitHub: https://github.com/jiebang-tools/jiebang-mcp-server
- 🔍 Smithery: https://smithery.ai/servers/ajie-jiebang/jiebang-tools
- 📡 MCP Endpoint: https://www.jiebang.site/mcp

## License

MIT