kanka-mcp

kanka-mcp

3.3

Kanka MCP is a Model Context Protocol server designed to interact with the Kanka API, enabling AI assistants to manage various elements of worldbuilding projects.

Kanka MCP is a server that facilitates interaction with the Kanka API, allowing users to manage campaigns, characters, locations, posts, notes, and journals within their Kanka worldbuilding projects. The server supports listing, retrieving, creating, updating, and deleting operations for these entities, with proper handling of HTML content and privacy settings. It is built to work with Python 3.10+ and requires the Kanka API key for authentication. The server can be run directly or integrated into an MCP server configuration for seamless operation.

Features

  • Campaign Management: List all user campaigns.
  • Character Management: List, retrieve, create, update, and delete characters.
  • Location Management: List, retrieve, create, update, and delete locations.
  • Post Management: List, retrieve, create, update, and delete posts for any entity.
  • Note and Journal Management: List, retrieve, create, update, and delete notes and journals.

Usage with Different Platforms

Running the MCP Server

bash
python kanka_mcp.py

Adding to MCP Server Configuration


"kanka": {
    "command": "python",
    "args": [
        "FULL_PATH_TO_SCRIPT_FOLDER/kanka_mcp.py"
    ],
    "env": {
        "KANKA_API_KEY": "YOUR_KANKA_API_KEY"
    }
}