swiftj/golk

Go SDK, MCP server and Claude Desktop/Cowork integration for the LegendKeeper worldbuilding wiki

Before you install: no copy-paste command · license MIT · link reachable

First step: git clone https://github.com/swiftj/golk.git

View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site

Install & config

Client config (built from the install command this repo gives)

{
  "mcpServers": {
    "swiftj-golk": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcpb@2.1.2"]
    }
  }
}

Parsed from the README we fetched on 2026-10-26; we have not executed it.

command/args come from the install command the repository states. When it is ambiguous, the project README wins.

VS Code (.vscode/mcp.json - the key is servers)

{
  "servers": {
    "swiftj-golk": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcpb@2.1.2"]
    }
  }
}

Same server, but VS Code keeps it under <code>servers</code>.

Claude Code (command line)

claude mcp add --transport stdio swiftj-golk -- npx -y @anthropic-ai/mcpb@2.1.2

Claude Code does not read a config file; add the server with this command.

Key names differ by client: Clients & CLI

Star count: 0 ★ · swiftj/golk · read from the GitHub search API · (checked 2026-11-13 20:00:50)
Source: read directly from its GitHub page · type: open-source project
Harvest history: first seen 2026-10-25 · last seen 2026-11-14 · seen 24× · listed by 1 sources
Score: score 103 · 1 sources · repo
Install: npx -y @anthropic-ai/mcpb@2.1.2

FAQ (answers come from our records)

How do I install it?

The repository provides this install command: npx -y @anthropic-ai/mcpb@2.1.2. It comes from the repository itself; we cannot guarantee it runs as-is in your client.

Who is it for?

We filed it under these tags: 开源项目. The tags come from the entry itself, not a taxonomy we imposed.

Who maintains it?

repository swiftj/golk；first catalogued 2026-10-25；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.

# 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:

Listed badge (optional)

Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.

[![Listed on Anclum](https://anclum.com/badge/listed.svg)](https://anclum.com/en/s/swiftj-golk/)

Source: github · https://github.com/swiftj/golk
Browse by field: Open source
added: today

More like this

martinambrus/haiveOpen-source project linny006/trending-claude-skillsOpen-source project zwznco/camberstack-mcpOpen-source project

All 1,671 →

Filed under

Open source1,671 entries Open-source repo2,514 From GitHub2,437

Every tag opens the full list for that filter. Counts are the live catalogue figures.

Browse all fields →

← Back to index