MCP Waifu Queue (Gemini Edition) logo

MCP Waifu Queue (Gemini Edition)

by waifuai

This project implements an MCP server for a conversational AI "waifu" character, leveraging the Google Gemini API via a Redis queue for asynchronous processing. It utilizes the `FastMCP` library for simplified server setup and management.

View on GitHub

Last updated: N/A

What is MCP Waifu Queue (Gemini Edition)?

An MCP server for a conversational AI character that uses the Google Gemini API for text generation and Redis for asynchronous request processing.

How to use MCP Waifu Queue (Gemini Edition)?

  1. Clone the repository. 2. Configure the environment variables, including the Gemini API key and Redis URL. 3. Start the Redis server. 4. Start the RQ worker. 5. Start the MCP server using uvicorn. 6. Send requests to the generate_text MCP tool with a prompt. 7. Retrieve job status and results using the job://{job_id} MCP resource.

Key features of MCP Waifu Queue (Gemini Edition)

  • Text generation using the Google Gemini API

  • Request queuing using Redis

  • MCP-compliant API using FastMCP

  • Job status tracking via MCP resources

Use cases of MCP Waifu Queue (Gemini Edition)

  • Creating a conversational AI character

  • Asynchronously processing text generation requests

  • Integrating with MCP-compliant clients

  • Building AI-powered applications

FAQ from MCP Waifu Queue (Gemini Edition)

Gemini API key not found?

Ensure you have created the ~/.api-gemini file in your home directory and placed your valid Gemini API key inside it.

Error during Gemini API call?

Double-check that the API key in ~/.api-gemini is correct and valid. Ensure the API is enabled for your Google Cloud project if applicable.

Jobs stuck in 'queued'?

Verify that the RQ worker is running in a separate terminal and connected to the same Redis instance specified in .env. Check the worker logs for errors.

ConnectionRefusedError (Redis)?

Make sure your Redis server is running and accessible at the REDIS_URL specified in .env.

MCP Server Connection Issues?

Ensure the MCP server is running and you are connecting to the correct host/port.