Add Bitcoin Knowledge Base (bkb-mcp) extension#8036
Add Bitcoin Knowledge Base (bkb-mcp) extension#8036tnull wants to merge 2 commits intoblock:mainfrom
bkb-mcp) extension#8036Conversation
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 47a35d7834
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
Mark `BKB_API_URL` as required since the upstream binary defaults to `http://127.0.0.1:3000`, not the public hosted API. Co-Authored-By: HAL 9000 Signed-off-by: Elias Rohrer <dev@tnull.de>
Add `BKB_API_URL` env var to CLI instructions and clarify that the variable is required, with the public API at \`https://bitcoinknowledge.dev\` as the recommended value. Co-Authored-By: HAL 9000 Signed-off-by: Elias Rohrer <dev@tnull.de>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 0bc6e011f6
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
| "id": "bkb-mcp", | ||
| "name": "Bitcoin Knowledge Base", | ||
| "description": "Search and reference tool for Bitcoin and Lightning development — indexes BIPs, BOLTs, bLIPs, LUDs, NUTs, GitHub issues/PRs, mailing lists, and more", | ||
| "command": "bkb-mcp", |
There was a problem hiding this comment.
Use a deeplink-safe command for Desktop installation
This registry entry advertises cmd=bkb-mcp, but Desktop deeplinks reject any stdio command outside the hard-coded allowlist in ui/desktop/src/components/settings/extensions/deeplink.ts:getStdioConfig (cu, docker, jbang, npx, uvx, goosed, npx.cmd, i-ching-mcp-server). Because the Extensions page builds its install URL directly from servers.json via documentation/src/utils/install-links.ts, clicking Install for this new extension will raise Invalid command instead of opening the add-extension flow, so Desktop users cannot install it through the advertised one-click path.
Useful? React with 👍 / 👎.
|
|
||
| :::tip Quick Install | ||
| 1. Install: `cargo install bkb-mcp` | ||
| 2. Configure: [Add BKB Extension](goose://extension?cmd=bkb-mcp&id=bkb-mcp&name=Bitcoin%20Knowledge%20Base&description=Search%20and%20reference%20tool%20for%20Bitcoin%20and%20Lightning%20development) |
There was a problem hiding this comment.
Include
BKB_API_URL in the quick-install deeplink
The quick-install link omits any env= parameter even though this page’s UI/CLI sections and servers.json both treat BKB_API_URL as required. In Desktop, deeplinks without env vars are installed immediately instead of opening the env-var modal (ui/desktop/src/components/settings/extensions/deeplink.ts:addExtensionFromDeepLink), so a reader who follows this 2-step quick start gets a bkb-mcp config that never prompts for the API URL and falls back to the server’s localhost default unless they are self-hosting BKB.
Useful? React with 👍 / 👎.
Summary
bkb-mcpas a community extension to Goosebkb-mcpis an MCP server for the Bitcoin Knowledge Base — a search and reference tool that indexes the Bitcoin and Lightning development ecosystem across BIPs, BOLTs, bLIPs, LUDs, NUTs, GitHub issues/PRs/commits, mailing lists, IRC logs,Delving Bitcoin, BitcoinTalk, and Optech newsletters
servers.jsonand a documentation page atdocs/mcp/bkb-mcpAvailable tools
bkb_searchbkb_get_documentbkb_get_referencesbkb_lookup_bipbkb_lookup_boltbkb_lookup_blipbkb_lookup_ludbkb_lookup_nutbkb_timelinebkb_find_commitTest plan
npm run buildindocumentation/succeeds/docs/mcp/bkb-mcpservers.json)