概览
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.
