Kanka MCP Server

Kanka MCP工具

用于Kanka世界建设API的本地MCP工具。通过stdio在您的计算机上运行，无需远程服务器。

先决条件

• Node.js 20+。
• Kanka API代币（在 kanka.io/en/settings/api).

安装

npm install

用法

MCP客户端配置（克劳德桌面、光标等）

将此添加到您的MCP客户端配置中：

{
  "mcpServers": {
    "kanka": {
      "command": "node",
      "args": ["/index.js"],
      "env": {
        "KANKA_API_TOKEN": ""
      }
    }
  }
}

笔记：

• 替换 `` 包含此存储库的完整路径。
• 在Windows上，更喜欢正斜杠(C:/Users/...)或逃过一劫(C:\\Users\\...).
• 编辑配置后重新启动MCP客户端。

直接运行

KANKA_API_TOKEN=your_token npm start

全局安装

npm install -g .
KANKA_API_TOKEN=your_token kanka-mcp

可用工具

该工具公开了82个MCP工具，用于与Kanka交互：

• list_campaigns --列出所有活动
• 搜索 --搜索活动中的实体
• 对于每种实体类型（角色、位置、家庭、组织、项目、注释、事件、日历、时间线、生物、种族、任务、地图、日记、能力、实体）：

- list_ --列出全部 - get_ --获取详细信息 - create_ --新建 - update_ --更新现有 - delete_ --删除现有

贡献

欢迎社区捐款。

• 阅读 贡献.md 用于工作流程、编码标准和PR检查表。
• 审查 代码_OF_CONDUCT.md 在参与之前。

当地质量检查

npm run lint
npm run format:check
npm test