A feature-rich Discord bot built with Spring Boot WebFlux, featuring AI conversations and web search capabilities.

中文文档

• Add to your server: Install Kage Bot
• Join our community: Discord Server ｜ 996Ninja 摸鱼忍者

I wanted to build a Chinese Discord bot that I could actually use. Mee6 is way too expensive, and with Claude by my side, I believe nothing is impossible. This project is the result of that vision.

• Streaming AI Responses - AI replies appear in real-time with typing indicator, per-user request queuing prevents conflicts
• MCP Integration - Added Jina MCP support for real-time web search and content reading
• Spring AI 1.1.0 - Upgraded to latest Spring AI with native MCP client support
• Multi-turn Conversations - AI remembers conversation context per user per server
• Refactored Command System - Clean command pattern architecture with easy extensibility

PRs are welcome! Feel free to contribute new features, bug fixes, or improvements.

• 🤖 AI Chat - Powered by DeepSeek API with multi-turn conversation support
• 🌐 Web Search - Integrated with Jina AI via MCP (Model Context Protocol) for real-time web search and content reading
• 🎰 Lottery System - Create lotteries, user participation, automatic drawing
• 📊 Poll System - Create polls with multiple options, supports multiple choice & anonymous voting
• ⏰ Off-work Countdown - Set countdown timer with periodic reminders
• 🔮 Daily Fortune - Check your daily fortune and slacking index
• 📝 Message Logging - Record server messages for analytics
• 🔧 Extensible Command System - Support for both traditional and slash commands
• 🚀 Horizontal Scaling - Redis-based event deduplication enables deployment across unlimited instances
• 🎵 Music Player - Play music in voice channels with queue management

You can also use commands by mentioning the bot:

Simply @BuBu to chat with AI, with support for real-time web search.

• Java 17+
• Spring Boot 3.5.x (WebFlux)
• Spring AI 1.1.0
• JDA 5.x (Java Discord API)
• PostgreSQL (R2DBC)
• Redis
• DeepSeek API (OpenAI-compatible)
• Jina MCP (Web Search)

┌─────────────────┐     ┌──────────────────┐
│  Discord User   │────▶│  Discord Gateway │
└─────────────────┘     └────────┬─────────┘
                                 │
                        ┌────────▼─────────┐
                        │   Kage Bot       │
                        │  (Spring Boot)   │
                        └────────┬─────────┘
                                 │
        ┌────────────────────────┼────────────────────────┐
        │                        │                        │
┌───────▼───────┐       ┌───────▼───────┐       ┌───────▼───────┐
│  DeepSeek AI  │       │   Jina MCP    │       │  PostgreSQL   │
│   (Chat AI)   │       │ (Web Search)  │       │  (Database)   │
└───────────────┘       └───────────────┘       └───────────────┘

• JDK 17+
• PostgreSQL 14+
• Redis 6+
• Maven 3.8+

Copy the example config file:

cp src/main/resources/application-dev.yaml.example src/main/resources/application-dev.yaml

Edit the configuration:

spring:
  r2dbc:
    url: r2dbc:postgresql://localhost:5432/kage
    username: postgres
    password: your_password
  data:
    redis:
      host: localhost
      port: 6379
      password: your_redis_password

spring.ai:
  openai:
    api-key: "your_deepseek_api_key"

jina:
  api-key: "your_jina_api_key"

discord:
  bot:
    token: "your_discord_bot_token"

• DeepSeek API Key: DeepSeek Platform
• Jina API Key: Jina AI (for web search)
• Discord Bot Token: Discord Developer Portal

psql -U postgres -d kage -f sql/chat_message.sql
psql -U postgres -d kage -f sql/user_message.sql
psql -U postgres -d kage -f sql/lottery.sql
psql -U postgres -d kage -f sql/poll.sql

# Development
./mvnw spring-boot:run -Dspring-boot.run.profiles=dev

# Production
./mvnw package -DskipTests
java -jar target/kage-*.jar

AI can automatically use the following tools when needed:

Implement the Command interface:

@Component
public class MyCommand implements Command {

    @Override
    public String getName() {
        return "mycommand";
    }

    @Override
    public String getDescription() {
        return "My command description";
    }

    @Override
    public void execute(MessageCommandContext context) {
        context.reply("Hello!");
    }
}

# Build image
./mvnw dockerfile:build

# Run
docker run -d \
  -e DB_URL=r2dbc:postgresql://host:5432/kage \
  -e DEEPSEEK_API_KEY=xxx \
  -e JINA_API_KEY=xxx \
  -e DISCORD_BOT_TOKEN=xxx \
  kage:latest

This project uses a custom license. Free for personal and non-commercial use. Commercial use requires authorization. See LICENSE for details.