MCP Waifu Chat Server

@waifuai

About MCP Waifu Chat Server

FastMCP server for conversational AI waifu with user management, dialog CRUD (get/set/reset), OpenRouter API integration, SQLite persistence, and modular extension architecture.

Config

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

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Waifu Chat Server?

MCP Waifu Chat Server implements a basic MCP server for a conversational AI “waifu” character. It uses the Python MCP library and FastMCP, providing user management, dialog history storage, and chat via the OpenRouter API.

How to use MCP Waifu Chat Server?

Clone the repository, install Python 3.10+ and uv, create a virtual environment, and install dependencies. Configure your OpenRouter API key (via OPENROUTER_API_KEY environment variable or ~/.api-openrouter file) and optional .env settings. Then run uv run mcp-waifu-chat to start the server.

Key features of MCP Waifu Chat Server

User management (create, check, delete, count)
Dialog history storage (get, set, reset)
Chat via OpenRouter API
SQLite database for persistence
Modular design for easy extension
Comprehensive unit tests

Use cases of MCP Waifu Chat Server

Building a conversational AI character for MCP clients
Managing multiple user chat sessions with persistent history
Prototyping and testing waifu chatbot interactions
Extending the server with custom AI providers or genres

FAQ from MCP Waifu Chat Server

What dependencies are required?

Python 3.10+, uv package manager, and an OpenRouter API key.

How do I configure the API key?

Set the OPENROUTER_API_KEY environment variable, or create a single-line key file at ~/.api-openrouter.

What database is used?

SQLite by default. The database file path is configurable via the DATABASE_FILE environment variable (default dialogs.db).

Can I use a different OpenRouter model?

Yes. Set OPENROUTER_MODEL_NAME environment variable or create ~/.model-openrouter file. Falls back to openrouter/free.

How do I run in production?

Use Gunicorn with Uvicorn workers (e.g., gunicorn --workers 4 --bind 0.0.0.0:8000 mcp_waifu_chat.api:app -k uvicorn.workers.UvicornWorker). Consider PostgreSQL, logging, HTTPS, and a reverse proxy.

Frequently asked questions

What dependencies are required?

Python 3.10+, uv package manager, and an OpenRouter API key.

How do I configure the API key?

Set the `OPENROUTER_API_KEY` environment variable, or create a single-line key file at `~/.api-openrouter`.

What database is used?

SQLite by default. The database file path is configurable via the `DATABASE_FILE` environment variable (default `dialogs.db`).

Can I use a different OpenRouter model?

Yes. Set `OPENROUTER_MODEL_NAME` environment variable or create `~/.model-openrouter` file. Falls back to `openrouter/free`.

How do I run in production?

Use Gunicorn with Uvicorn workers (e.g., `gunicorn --workers 4 --bind 0.0.0.0:8000 mcp_waifu_chat.api:app -k uvicorn.workers.UvicornWorker`). Consider PostgreSQL, logging, HTTPS, and a reverse proxy.

Comments

Basic information

More AI & Agents MCP servers

PDI Bridge for Claude

jxrlabs

Connect Claude Desktop to your ServiceNow PDI. Query records, inspect Business Rules, review ACLs, and troubleshoot against your live instance.

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

Legion MCP

faulkj

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

Transform MCP

Unstructured

The Unstructured Transform MCP Server connects your ADK agent to Unstructured, a document processing platform that turns raw files into structured, AI-ready data. This integration gives your agent the ability to parse PD

Just Domain.

Just.

Just Domain is the domain registrar for businesses built with AI. An AI assistant checks availability and both prices, first year and renewal, and hands back a checkout link for justdomain.ai. Read only by design: no pur