mcp-waifu-chat

mcp-waifu-chat

2

MCP Waifu Chat Server is a conversational AI server featuring a "waifu" character, using Python and FastMCP. It offers functionalities like user management and dialog storage, with AI responses from Google's Gemini API.

MCP Waifu Chat Server

This project is a Model Context Protocol (MCP) server for a conversational AI "waifu" character. It is implemented in Python and uses FastMCP for server setup. Key features include:

  • User management and dialog history storage
  • Basic chat functionality via the Google Gemini API
  • Modular design for easy extension
  • Uses SQLite for data persistence
  • Includes comprehensive unit tests

Installation and Configuration

The server requires Python 3.10+, uv, and a Google Gemini API Key. Configuration is handled via environment variables and a .env file. To run, ensure your API key is configured and execute: uv run mcp-waifu-chat.

Key Components

  • LLM integration for AI responses using Google Gemini
  • MCP-compliant API endpoints for server status, user management, dialog management, and chat functionality.