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.
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)?
- 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 thejob://{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?
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?
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'?
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)?
ConnectionRefusedError (Redis)?
Make sure your Redis server is running and accessible at the REDIS_URL
specified in .env
.
MCP Server Connection Issues?
MCP Server Connection Issues?
Ensure the MCP server is running and you are connecting to the correct host/port.