RisuAI
Make your own story. User-friendly software for LLM roleplaying
What is RisuAI?
RisuAI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to make your own story. user-friendly software for llm roleplaying
Make your own story. User-friendly software for LLM roleplaying
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Make your own story. User-friendly software for LLM roleplay
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx risuaiConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use RisuAI
RisuAI (Risu) is a cross-platform AI chat and roleplaying application that supports multiple LLM backends including OpenAI, Claude, Gemini, DeepInfra, OpenRouter, and local models via Ooba. It offers rich roleplaying features such as character emotion images, group chats with multiple characters, a lorebook/world-info system, regex-based output scripting, long-term memory compression, and powerful prompt customization. Writers, storytellers, and hobbyists use it to create immersive interactive fiction with full control over model selection and conversation structure, running either as a web app or a native desktop application built with Tauri.
Prerequisites
- Node.js 20.19+ or 22.12+ (for development builds)
- pnpm package manager (for development builds)
- An API key for at least one supported provider: OpenAI, Anthropic, Google Gemini, or an OpenRouter account
- Docker (optional, for self-hosted web deployment)
- An MCP-compatible client if integrating via the MCP interface
Access RisuAI via the web or download the desktop app
The fastest way to get started is to visit risuai.net directly in your browser. For a native desktop experience, download the latest release for your platform (Windows, macOS, or Linux) from the GitHub Releases page.
https://risuai.net
# or download from:
https://github.com/kwaroran/Risuai/releasesConfigure your AI provider and API key
Open the Settings panel and navigate to the AI Provider section. Select your provider (e.g., OpenAI, Claude, Gemini, OpenRouter) and paste in your API key. RisuAI never transmits your key to its own servers — it calls the provider API directly from your browser or desktop.
Create or import a character
Use the character creation wizard to define a persona with a name, description, personality, and optional emotion images. You can also import character cards in the standard YAML/PNG format shared by the community.
(Optional) Self-host with Docker
Run a self-hosted RisuAI web instance using the provided docker-compose file. The service listens on port 6001.
curl -L https://raw.githubusercontent.com/kwaroran/Risuai/refs/heads/main/docker-compose.yml | docker compose -f - up -d
# Access at: http://localhost:6001Add to Claude Desktop via MCP
To expose RisuAI capabilities through MCP, add the server configuration to your Claude Desktop config file.
RisuAI Examples
Client configuration
Add RisuAI as an MCP server in your Claude Desktop configuration file.
{
"mcpServers": {
"risuai": {
"command": "npx",
"args": ["risuai"],
"env": {}
}
}
}Prompts to try
These prompts work well for roleplaying and collaborative storytelling sessions inside RisuAI.
- "Continue the story where my character enters the enchanted forest and encounters a mysterious figure."
- "Switch to the character's angry emotional state and respond to the accusation."
- "Add a new character to our group chat: a cynical merchant who has seen it all."
- "Translate my next message into Japanese before sending it to the AI character."
- "Summarize the last 20 messages into the lorebook so context is preserved."Troubleshooting RisuAI
API calls fail with an authentication error
Double-check that the correct API key is entered in Settings > AI Provider. OpenAI keys start with 'sk-', Anthropic keys with 'sk-ant-'. Also confirm your account has billing enabled for the chosen provider.
Character emotion images are not displaying
Emotion images must be attached to the character card in a supported format (PNG sprites with emotion labels). Ensure the character was imported with emotion assets bundled, or add them manually via the character editor's Expressions tab.
Long conversations lose context or forget earlier events
Enable HypaMemoryV2/V3 or SupaMemory in the model settings. These memory compression systems summarize older messages and inject the summary back into the context window, preserving long-term story continuity.
Frequently Asked Questions about RisuAI
What is RisuAI?
RisuAI is a Model Context Protocol (MCP) server that make your own story. user-friendly software for llm roleplaying It connects AI assistants to external tools and data sources through a standardized interface.
How do I install RisuAI?
Follow the installation instructions on the RisuAI GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with RisuAI?
RisuAI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is RisuAI free to use?
Yes, RisuAI is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.
RisuAI Alternatives — Similar Communication Servers
Looking for alternatives to RisuAI? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up RisuAI in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use RisuAI?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.