Generates asynchronous text responses using a distilgpt2 model, managed through a Redis queue and accelerated with GPU support, exposing an
If you already use Waifu Queue, the waifu queue mcp server is the piece that lets your assistant work with it directly. Generates asynchronous text responses using a distilgpt2 model, managed through a Redis queue and accelerated with GPU support, exposing an MCP-compliant API.
This project implements an MCP (Model Context Protocol) server for a conversational AI "waifu" character, leveraging the OpenRouter API via a Redis queue for asynchronous processing. It utilizes the FastMCP library for simplified server setup and management.
uvicorn on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
Description — ** Sends a text generation request to the OpenRouter API via the background queueInput — ** {"prompt": "Your text prompt here"} (Type: GenerateTextRequest)Output — ** {"job_id": "rq:job:..."} (A unique ID for the queued job)Tools — The Tools tool exposed by this serverResources — The Resources tool exposed by this serverConfiguration is passed through the environment: OPENROUTER_API_KEY, YOUR_REPOSITORY_URL, REDIS_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
pip or uv (Python package installer) * Redis server (installed and running) * An OpenRouter API Key You can find instructions for installing Redis on your system on the official Redis website: https://redis.io/docs/getting-started/ You can obtain an OpenRouter API key from: https://openrouter.ai/Plenty of database access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Waifu Queue's toolset — Description, Input, Output and 2 more — is a fair guide to whether it matches your workflow. It is maintained by waifuai; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| Tool | What it does |
|---|---|
| Description | ** Sends a text generation request to the OpenRouter API via the background queue. |
| Input | ** {"prompt": "Your text prompt here"} (Type: GenerateTextRequest) |
| Output | ** {"job_id": "rq:job:..."} (A unique ID for the queued job) |
| Tools | The Tools tool exposed by this server. |
| Resources | The Resources tool exposed by this server. |
{
"mcpServers": {
"waifu-queue": {
"command": "uvx",
"args": ["uvicorn"],
"env": {
"OPENROUTER_API_KEY": "your-value",
"YOUR_REPOSITORY_URL": "your-value",
"REDIS_URL": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
pip or uv (Python package installer) * Redis server (installed and running) * An OpenRouter API Key You can find instructions for installing Redis on your system on the official Redis website: https://redis.io/docs/getting-started/ You can obtain an OpenRouter API key from: https://openrouter.ai/| Variable | Description | Required |
|---|---|---|
| OPENROUTER_API_KEY | Credential the server authenticates with. | Yes |
| YOUR_REPOSITORY_URL | Endpoint or connection string the server talks to. | Yes |
| REDIS_URL | Endpoint or connection string the server talks to. | Yes |
Read-only SQL access to Postgres — let your assistant inspect schemas and answer questions from real data.
Manage your whole Supabase project in conversation — database, auth, storage, Edge Functions and branches.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Official MongoDB server covering data, schemas and Atlas management — from find queries to spinning up clusters.
Serverless Postgres with database branching — point your assistant at Neon and let it work on disposable copies.