Advertise
MCP.so
Sign In

MCP Waifu Queue (Gemini Edition)

@waifuai

Repository

Basic information

Category

AI & Agents

License

MIT-0

Transports

stdio

Author

waifuai

About MCP Waifu Queue

FastMCP server for asynchronous conversational AI using OpenRouter API via Redis queue/worker architecture. GPU inference support, environment-variable configuration, and deployment-ready setup.

#mcp#waifu#queue#conversational-ai#text-generation

MCP Waifu Queue config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-waifu-queue": {
      "command": "python",
      "args": [
        "-m",
        "uv",
        "venv",
        ".venv"
      ]
    }
  }
}

MCP Waifu Queue tools

1

** Sends a text generation request to the OpenRouter API via the background queue.

Overview

What is MCP Waifu Queue (Gemini Edition)?

MCP Waifu Queue (Gemini Edition) is an MCP server for a conversational AI “waifu” character. It uses the OpenRouter API (via a Redis queue) for asynchronous text generation and is built with the FastMCP library.

How to use MCP Waifu Queue (Gemini Edition)?

Install dependencies and configure OpenRouter API key and model selection (via environment variables or home‑directory files). Start a Redis server, then run the RQ worker (python -m mcp_waifu_queue.worker) and the MCP server (e.g., with uvicorn mcp_waifu_queue.main:app). Clients interact with the generate_text tool and the job://{job_id} resource.

Key features of MCP Waifu Queue (Gemini Edition)

  • Text generation via OpenRouter using a configurable model.
  • Request queuing with Redis for asynchronous processing.
  • MCP‑compliant API using the FastMCP library.
  • Job status tracking through MCP resources.
  • API key loading from environment variables or file fallbacks.
  • Pydantic‑based request and response validation.

Use cases of MCP Waifu Queue (Gemini Edition)

  • Building a conversational AI assistant with a predefined character.
  • Queuing long‑running text generation requests without blocking the client.
  • Integrating a waifu chatbot into MCP‑compatible tools and agents.
  • Offloading generation workloads to a background worker for scalability.

Frequently asked questions

1

What models can be used?

The server uses the model specified in `~/.model-openrouter` or defaults to `openrouter/free`. You can use any model available via the OpenRouter API.

2

How do I get an OpenRouter API key?

Obtain a key from [openrouter.ai](https://openrouter.ai/) and set it as the `OPENROUTER_API_KEY` environment variable or place it in `~/.api-openrouter`.

3

What is Redis used for?

Redis is required to queue text generation requests. The RQ worker picks up jobs from the queue and processes them asynchronously.

4

How can I check the status of a submitted job?

After calling the `generate_text` tool, you receive a `job_id`. Use the `job://{job_id}` MCP resource to retrieve the job status and result.

5

What are the runtime dependencies?

Python 3.7+, a running Redis server, and the packages listed in `requirements.txt`. The server also needs an OpenRouter API key and network access to OpenRouter.

Comments

More AI & Agents MCP servers

scvd.store

seancrecord

scvd.store is an evidence observatory for agentic commerce. Independent signed observation of what other people's endpoints, artifacts and payments actually did among other things. USDC on Base, Arbitrum One, World Chain

2

Nova Data Analytics

nova-data-analytics

Amazon Seller Central MCP server. Connect Seller Central, Vendor Central and Amazon Ads to Claude, ChatGPT, Gemini or Cursor, and ask for net profit per SKU with your own COGS, VAT and FBM shipping costs, PPC down to the

strac-mcp-dlp

strac-io

Detect and redact PII, PHI, PCI and secrets — SSNs, credit cards, passports, API keys and cloud credentials — in text and in local files, using the Strac DLP API. Five tools: redact_text, detect_sensitive_data, detect_fi

3
L

Legion MCP

faulkj

MCP-native LLM councils for debates, juries, blind panels, voting, refinement, and custom multi-model deliberation.

1

Gemina

Gemina Tech Ltd.

Extract, search and tag any document — invoices, receipts, contracts, forms, or your own templates. 13 tools, one sign-in (OAuth 2.1) or API key, free FileTag tier, data residency in the EU, US, Israel or Asia.

Advertise