KoikatuMCP

Overview

KoikatuMCP is a Model Context Protocol server that bridges AI assistants with Koikatu Studio, enabling control through natural language commands. It connects to the KKStudioSocket WebSocket plugin to manipulate scenes, objects, characters, and more. The server implements scene management, camera control, content discovery, and object manipulation features, making it possible for AI systems to interact with this character creation software.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• ping

  Test connection to Koikatsu Studio via KKStudioSocket

  Try:Please run a ping to check the connection!Try:Is the Koikatsu Studio connection working?
• treetree(depth?: number)

  Retrieve scene hierarchy and structure of objects in the scene

  Try:What items are currently placed in the scene?Try:Show me the scene tree with depth 3Try:List all objects in the current scene
• add_object

  Add objects to the scene (items, lights, cameras, characters)

  Try:Add a new camera to the sceneTry:Place a red chair in position (0,0,0)Try:Add a character to the scene
• modify_object

  Modify object properties like position, rotation, scale, and color

  Try:Move the character to position (10, 5, 0)Try:Rotate the camera 45 degreesTry:Scale the item by 1.5
• remove_object

  Remove objects from the scene

  Try:Remove the selected chairTry:Delete all lights except the main oneTry:Get rid of the object with ID 127
• camera_control

  Control camera position, orientation, and switch between views

  Try:Move camera to position (5, 10, 15)Try:Set camera to look at characterTry:Switch to first-person view
• capture_screenshot

  Capture screenshots of the current scene

  Try:Take a screenshotTry:Capture the current view and save itTry:Take a picture of the scene
• browse_items

  Browse available item catalogs in Koikatsu Studio

  Try:What items are available in the furniture category?Try:Show me all character itemsTry:List available lighting options
• search_items

  Search for specific items in the catalog

  Try:Find red chairsTry:Search for bedroom furnitureTry:Look for character accessories
• get_item_info

  Get detailed information about a specific item

  Try:Tell me about item ID 127Try:What can you tell me about this character?Try:Describe the selected furniture piece
• attach_object

  Attach objects to create hierarchies

  Try:Attach the lamp to the tableTry:Connect the character's hand to the cupTry:Make the hair follow the head movement
• modify_lighting

  Adjust lighting properties in the scene

  Try:Make the room brighterTry:Change ambient light color to blueTry:Add a spotlight pointing at the character

Comparable tools

Installation

FAQ

Which games does KoikatuMCP support?

KoikatuMCP supports both Koikatu (KK) and Koikatsu Sunshine (KKS) games, as long as the KKStudioSocket plugin is installed.

How do I verify the connection between KoikatuMCP and Koikatu Studio?

You can test the connection by asking your AI assistant to 'run a ping to check the connection' which will execute a `koikatu-mcp:ping` command to verify the connection to KKStudioSocket.

Can I use KoikatuMCP with other AI assistants besides Claude?

Yes, KoikatuMCP should work with any MCP client that can execute external commands. The provided configuration examples show how to set it up with Claude Desktop, but it may work with other AI systems that support MCP.

Compare KoikatuMCP with