A Model Context Protocol (MCP) server that enables AI assistants to control Koikatsu Studio through natural language commands.
{
"mcpServers": {
"koikatu-mcp": {
"env": {
"KKSTUDIOSOCKET_URL": "ws://127.0.0.1:8765/ws"
},
"command": "Paste the full path to KoikatuMCP.exe here"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
A Model Context Protocol (MCP) server that enables AI assistants to control Koikatsu Studio through natural language commands.
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
MIT. View license →
Is it maintained?
Last commit 261 days ago. 4 stars.
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
No automated test available for this server. Check the GitHub README for setup instructions.
No known vulnerabilities.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationHave you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Dynamic problem-solving through sequential thought chains
A Model Context Protocol server for searching and analyzing arXiv papers
An open-source AI agent that brings the power of Gemini directly into your terminal.
The official Python SDK for Model Context Protocol servers and clients
MCP Security Weekly
Get CVE alerts and security updates for KoikatuMCP and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
日本語 | English
A Model Context Protocol (MCP) server that enables AI assistants to control Koikatsu Studio through natural language commands.
Follow the KKStudioSocket installation guide to set up the WebSocket plugin.
KoikatuMCP.exe (single executable file)README.md (this file)LICENSE (license information)Add the following configuration to your Claude Desktop MCP settings:
KoikatuMCP.exe (Right-click the KoikatuMCP.exe file inside the unzipped folder → Select "Copy as path")%APPDATA%\Claude. Open claude_desktop_config.json in a text editor.{
"mcpServers": {
"koikatu-mcp": {
"command": "Paste the full path to KoikatuMCP.exe here",
"env": {
"KKSTUDIOSOCKET_URL": "ws://127.0.0.1:8765/ws"
}
}
}
}
⚠️ Note: Backslashes in the path must be escaped by doubling them. Example:
❌ Incorrect: "C:\Users\user\Downloads\KoikatuMCP.exe"
✅ Correct: "C:\\Users\\user\\Downloads\\KoikatuMCP.exe"
Add to your claude_desktop_config.json:
{
"mcpServers": {
"koikatu-mcp": {
"command": "C:\\path\\to\\KoikatuMCP.exe"
}
}
}
You can verify whether KKStudioSocket is loaded correctly by checking for the following lines in output_log.txt:
[Info : BepInEx] Loading [KKStudioSocket 1.0.0]
[Info :KKStudioSocket] Awaking KKStudioSocket v1.0.0
With the MCP configuration in place, KoikatuMCP will automatically connect when you start a conversation.
> Please run a ping to check the connection!
● Executing connection check to KKStudioSocket!
● `koikatu-mcp:ping` (MCP) (message: "Connection test")
⎿ ✅ Ping successful! Server responded with: Connection test
● ✅ Connection successful!
The connection to KKStudioSocket has been successfully established.
The WebSocket server is functioning correctly, and KoikatuMCP is now able to communicate with Koikatsu Studio.
You can now use all available features, including scene manipulation, item placement, and camera control!
> What items are currently placed in the scene?
● To check which items are placed in the current scene, let's retrieve the scene tree.
● `koikatu-mcp:tree` (MCP) (depth: 2)
⎿ 🌲 Scene Tree:
📦 Folder (ID: 127, Type: OCIFolder)
🎯 Position: (3.79, -1.54, -16.95)
… +821 lines (ctrl+r to expand)
● The following items are currently placed in the scene:
**Main Objects**
1. **Character**
... [View full README on GitHub](https://github.com/great-majority/KoikatuMCP#readme)