S
swiftj/golk
Go SDK, MCP server and Claude Desktop/Cowork integration for the LegendKeeper worldbuilding wiki
在 GitHub 查看 ↗链接已于 2026-11-12 核查 · HTTP 200 · 打开的是厂商自己的官网
安装与配置
客户端配置（取自该仓库的安装命令）
{
"mcpServers": {
"swiftj-golk": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcpb@2.1.2"]
}
}
}解析自我们于 2026-10-26 抓取的该仓库 README；我们未执行过。
command/args 来自仓库写明的安装命令；不确定时请以该项目 README 为准。
VS Code（.vscode/mcp.json —— 键名是 servers）
{
"servers": {
"swiftj-golk": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcpb@2.1.2"]
}
}
}VS Code 顶层键是 <code>servers</code>，其余与上面那份相同。
Claude Code（命令行）
claude mcp add --transport stdio swiftj-golk -- npx -y @anthropic-ai/mcpb@2.1.2
Claude Code 不收 JSON 文件，用这条命令直接加。
配置项的键名以你的客户端为准：客户端与 CLI
- ★ 数取值
- 0 ★ · swiftj/golk · 取自 GitHub 搜索 API · （2026-11-13 20:00:50 核对）
- 来源明细
- 从该仓库的 GitHub 页面直接读取 · 条目类型：开源项目
- 收录与活跃
- 收录于 2026-10-25 · 最近见到 2026-11-14 · 共见到 24 次 · 被 1 个来源列出
- 评分构成
- 综合分 103 · 1 个来源 · repo
- 安装
npx -y @anthropic-ai/mcpb@2.1.2
常见问题（答案都来自我们的记录）
怎么安装？
该仓库给出的安装命令是
npx -y @anthropic-ai/mcpb@2.1.2。我们的记录里它是仓库自己提供的；不保证在你的客户端上直接可用。它适合谁 / 用来做什么？
我们把它归在这些标签下: 开源项目。标签来自条目自身，不是我们强加的分类。
谁维护它、还在更新吗？
仓库
swiftj/golk；我们收录于 2026-10-25；最近见到 2026-11-14。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。# golk: LegendKeeper for Go and Claude
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
golk connects LegendKeeper, the worldbuilding wiki, to Go programs and to Claude. It has three parts:
| Part | What it is | For |
| lk | A Go SDK for the LegendKeeper v3 REST API: retries, idempotency, versioned writes, pagination, rate limiting, typed blocks, and a lossless Markdown converter | Go developers |
| lk-mcp | An MCP server with 60 task-shaped tools and 4 prompts, covering 100% of the LegendKeeper API, built on lk | Claude Desktop (chat and Cowork), Claude Code and any MCP client |
| Claude Desktop extension and plugin | A one-click Claude Desktop extension (.mcpb), plus a plugin with two skills | People who want Claude to read and write their wiki |
It was built for a DM who publishes a D&D world wiki that players read. So it puts correctness, data safety, and keeping DM-only content away from players ahead of speed:
Versioned writes never overwrite an edit made in the app since Claude read the page.
Every write tool has a dry run.
An optional spoiler guard refuses any write that would show a protected term to players.
> This project is not affiliated with or endorsed by LegendKeeper.
## Contents
Quick start (Claude Desktop)
Install in Claude Desktop
What Claude can do
lk-mcp, the MCP server
The spoiler guard
LK Markdown
The lk Go SDK
Building from source
Testing
Repository layout
Design documents
Supported platforms
License
## Quick start (Claude Desktop)
You need an Apple Silicon Mac with Claude Desktop 3.6556.2 or later, a LegendKeeper project and an API key for it. Use a test project first.
Download lk-mcp-darwin-arm64.mcpb and legendkeeper-plugin.zip from the latest release, or build them yourself:
sh
git clone https://github.com/swiftj/golk.git
cd golk
make mcpb plugin # needs Go 1.27+ and Node (npx) for the packer
1. Double-click lk-mcp-darwin-arm64.mcpb and enter your API key.
2. In a new chat, ask: "List my LegendKeeper projects."
3. Recommended: in Claude Desktop, open Customize and choose Add › Upload plugin, then pick legendkeeper-plugin.zip. This adds the two skills to every chat and every Cowork task. Cowork is part of Claude Desktop, so it uses the same extension, with nothing else to set up.
## Install in Claude Desktop
Cowork is part of Claude Desktop, so everything below covers both chat and Cowork. The integration has two pieces, installed separately. (Why not one file? A plugin can carry an .mcpb, but Claude Desktop ignores a local server inside a plugin in chat. Cowork ignores it too when a setting has no default, as the API key doesn't. The extension is what gets prompted for settings. See D-019.)
| Piece | File | Contains |
| Claude Desktop extension | dist/lk-mcp-darwin-arm64.mcpb | The lk-mcp server binary and its settings. This is what gives Claude the LegendKeeper tools. |
| Plugin (skills) | dist/legendkeeper-plugin.zip | Two skills that teach Claude to use the tools well: legendkeeper-wiki (pages, LK Markdown, hidden content, the guard) and legendkeeper-worldbuilding (maps, timelines, calendars, templates, boards). It holds no server and no key. |
### 1. Get them
Download both from the releases page, and check them with shasum -a 256 -c SHA256SUMS. Or build them:
| Part | What it is | For |
| lk | A Go SDK for the LegendKeeper v3 REST API: retries, idempotency, versioned writes, pagination, rate limiting, typed blocks, and a lossless Markdown converter | Go developers |
| lk-mcp | An MCP server with 60 task-shaped tools and 4 prompts, covering 100% of the LegendKeeper API, built on lk | Claude Desktop (chat and Cowork), Claude Code and any MCP client |
| Claude Desktop extension and plugin | A one-click Claude Desktop extension (.mcpb), plus a plugin with two skills | People who want Claude to read and write their wiki |
It was built for a DM who publishes a D&D world wiki that players read. So it puts correctness, data safety, and keeping DM-only content away from players ahead of speed:
Versioned writes never overwrite an edit made in the app since Claude read the page.
Every write tool has a dry run.
An optional spoiler guard refuses any write that would show a protected term to players.
> This project is not affiliated with or endorsed by LegendKeeper.
## Contents
Quick start (Claude Desktop)
Install in Claude Desktop
What Claude can do
lk-mcp, the MCP server
The spoiler guard
LK Markdown
The lk Go SDK
Building from source
Testing
Repository layout
Design documents
Supported platforms
License
## Quick start (Claude Desktop)
You need an Apple Silicon Mac with Claude Desktop 3.6556.2 or later, a LegendKeeper project and an API key for it. Use a test project first.
Download lk-mcp-darwin-arm64.mcpb and legendkeeper-plugin.zip from the latest release, or build them yourself:
sh
git clone https://github.com/swiftj/golk.git
cd golk
make mcpb plugin # needs Go 1.27+ and Node (npx) for the packer
1. Double-click lk-mcp-darwin-arm64.mcpb and enter your API key.
2. In a new chat, ask: "List my LegendKeeper projects."
3. Recommended: in Claude Desktop, open Customize and choose Add › Upload plugin, then pick legendkeeper-plugin.zip. This adds the two skills to every chat and every Cowork task. Cowork is part of Claude Desktop, so it uses the same extension, with nothing else to set up.
## Install in Claude Desktop
Cowork is part of Claude Desktop, so everything below covers both chat and Cowork. The integration has two pieces, installed separately. (Why not one file? A plugin can carry an .mcpb, but Claude Desktop ignores a local server inside a plugin in chat. Cowork ignores it too when a setting has no default, as the API key doesn't. The extension is what gets prompted for settings. See D-019.)
| Piece | File | Contains |
| Claude Desktop extension | dist/lk-mcp-darwin-arm64.mcpb | The lk-mcp server binary and its settings. This is what gives Claude the LegendKeeper tools. |
| Plugin (skills) | dist/legendkeeper-plugin.zip | Two skills that teach Claude to use the tools well: legendkeeper-wiki (pages, LK Markdown, hidden content, the guard) and legendkeeper-worldbuilding (maps, timelines, calendars, templates, boards). It holds no server and no key. |
### 1. Get them
Download both from the releases page, and check them with shasum -a 256 -c SHA256SUMS. Or build them:
收录徽章（可选）
想把收录标记放进 README 就复制这行，可选，不影响收录。
[](https://anclum.com/zh/s/swiftj-golk/)
- 来源
- github · https://github.com/swiftj/golk
- 按领域浏览
- 开源项目
- 收录于
- 今天
同类推荐
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。