概要
What is Kanka MCP?
Kanka MCP is a Model Context Protocol server that enables AI assistants to interact with the Kanka API for worldbuilding projects. It allows managing campaigns, characters, locations, posts, notes, and journals.
How to use Kanka MCP?
Set the KANKA_API_KEY environment variable with your Kanka API key, then run python kanka_mcp.py. Add the server to your MCP configuration with the command and environment variable.
Key features of Kanka MCP
- Tools for campaigns, characters, locations, posts, notes, and journals.
- Create, read, update, and delete operations for all entity types.
- Full CRUD support with HTML content and privacy settings.
- Simple Python-based installation with minimal dependencies.
- Designed for integration with any MCP-compatible AI assistant.
Use cases of Kanka MCP
- AI-assisted campaign management for tabletop RPGs.
- Automating creation and editing of characters, locations, and notes.
- Querying worldbuilding data from Kanka through natural language.
- Updating entity descriptions and privacy settings via an AI interface.
FAQ from Kanka MCP
What dependencies does Kanka MCP require?
Python 3.10+ and the requests and mcp[cli] packages.
How do I get a Kanka API key?
Log in to your Kanka account, go to Account Settings, then the API section, and create or copy your API token.
Where does Kanka MCP store data?
Data is stored exclusively in the Kanka platform; the server acts as a stateless API bridge.
What transport does Kanka MCP use?
The server uses standard I/O transport per the MCP specification.
How is authentication handled?
Authentication is via the KANKA_API_KEY environment variable, which is passed to the Kanka API.
