Skip to content

Code graph and memory for your coding agents, in one Rust program. For Claude Code, Codex, Cursor and any MCP client.

MCP bundles and the registry entry show the Graphicle icon

VikramLexfa8d3e422e04
diff --git a/.github/workflows/mcp-registry.yml b/.github/workflows/mcp-registry.yml
index 82fe0d3..1b59fb9 100644
--- a/.github/workflows/mcp-registry.yml
+++ b/.github/workflows/mcp-registry.yml
@@ -6,7 +6,8 @@
# The build job, which can only read the repository, checks the release,
# downloads its five archives, builds one MCP bundle per target with
# packaging/mcpb/build_mcpb.py (graphicle-<version>-<target>.mcpb), writes
-# server.json with packaging/mcpb/render_server_json.py and validates it. The
+# server.json with packaging/mcpb/render_server_json.py, checks that the
+# address of its icon serves packaging/mcpb/icon.png and validates it. The
# publish job uploads the bundles to the release, checks the uploaded files,
# publishes server.json with mcp-publisher, which logs in with the run's GitHub
# OIDC token (no secret is needed), and reads the listing back.
@@ -111,6 +112,9 @@ jobs:
python3 packaging/mcpb/render_server_json.py --version "$VERSION" --bundles "$RUNNER_TEMP/mcpb" \
--out "$RUNNER_TEMP/server.json"
cat "$RUNNER_TEMP/server.json"
+ # The listed icon address never changes, so it must serve this commit's icon now.
+ curl -fsS -o "$RUNNER_TEMP/icon.png" "$(jq -r '.icons[0].src' "$RUNNER_TEMP/server.json")"
+ cmp "$RUNNER_TEMP/icon.png" packaging/mcpb/icon.png
{
echo "server.json for $SERVER_NAME $VERSION (once the run has published it, commit it at the repository's root):"
echo
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a55c539..1038978 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,15 @@
Notable changes to Graphicle: the graph engine (`graphicle-graph`), the memory
library (`graphicle-memory`) and the `graphicle` program.
+## Unreleased
+
+### MCP Registry
+
+- Each MCP bundle holds the Graphicle icon, which Claude Desktop shows beside
+ the extension, and the registry entry links to the same icon
+ (`packaging/mcpb/icon.png`). The workflow builds a release's bundles with
+ the scripts on main, so the bundles of 0.1.2 have the icon too.
+
## 0.1.2 - 2026-10-18
Every crate is at 0.1.2, and `graphicle --version` prints
diff --git a/packaging/mcpb/README.md b/packaging/mcpb/README.md
index 09ecd7e..e14a3e9 100644
--- a/packaging/mcpb/README.md
+++ b/packaging/mcpb/README.md
@@ -21,6 +21,10 @@ that `graphicle sync` has set up.
- `server/graphicle` (`server/graphicle.exe` on Windows): the archive's program,
byte for byte. `graphicle-graph` stays out, because `graphicle mcp` links the
graph engine and never runs it;
+- `icon.png`: the Graphicle icon, 512 x 512 pixels, which clients such as
+ Claude Desktop show beside the server. It is [icon.png](icon.png) in this
+ folder, [icon.svg](icon.svg) drawn as a PNG (for example with a browser's
+ headless screenshot at a 512 x 512 window);
- `LICENSE`, `NOTICE`, `NOTICE.md` and `licenses/` from the archive.
The server serves a project that `graphicle sync` has set up. It does not index
@@ -48,6 +52,11 @@ step 3 below commits the entry the workflow published at the repository's root.
packages are listed with the most common machine of each system first
(Apple silicon before Intel, x86-64 Linux before Arm64).
- The description has at most 100 characters, the registry's limit.
+- The icon is the bundles' `icon.png`, by its address on
+ raw.githubusercontent.com in the commit of main that the workflow run checked
+ out, so the listed address keeps working when main moves on. Before it
+ publishes, the workflow downloads the icon from that address and compares it
+ with the file. Outside GitHub Actions, the address names main.
## Steps at release time
diff --git a/packaging/mcpb/build_mcpb.py b/packaging/mcpb/build_mcpb.py
index 70af6d2..b3c4c2c 100755
--- a/packaging/mcpb/build_mcpb.py
+++ b/packaging/mcpb/build_mcpb.py
@@ -18,6 +18,9 @@ OUT/graphicle-<version>-<target>.mcpb, and it holds
server/ the archive's program, graphicle (graphicle.exe on
Windows), executable. graphicle-graph stays out:
`graphicle mcp` links the graph engine and never runs it
+ icon.png the Graphicle icon beside this script, 512 x 512 pixels
+ (icon.svg drawn as a PNG), which clients show with the
+ server
LICENSE, NOTICE, NOTICE.md and licenses/
the archive's licence and notices, which go wherever the
program goes
@@ -37,6 +40,7 @@ import json
import os
import re
import stat
+import struct
import sys
import tarfile
import time
@@ -67,6 +71,12 @@ LEGAL_EXTRA = ['NOTICE.md']
LICENCES = 'licenses/'
# The files a bundle takes from an archive stay below this size together.
MAX_TOTAL = 1 << 30
+# The icon every bundle holds as icon.png: the logo on the dark background of
+# the organization's avatar, icon.svg drawn at 512 x 512 pixels. Its path in
+# the repository, where render_server_json.py links server.json to it.
+ICON = 'packaging/mcpb/icon.png'
+ICON_SIZE = 512
+ROOT = Path(__file__).resolve().parents[2]
def fail(message):
@@ -75,6 +85,15 @@ def fail(message):
sys.exit(message)
+def icon():
+ """The icon's bytes, which must be a PNG of ICON_SIZE by ICON_SIZE pixels."""
+ path = ROOT / ICON
+ data = path.read_bytes() if path.is_file() else b''
+ if data[:8] != b'\x89PNG\r\n\x1a\n' or data[12:24] != b'IHDR' + struct.pack('>II', ICON_SIZE, ICON_SIZE):
+ fail(f'{ICON} is not a PNG of {ICON_SIZE} x {ICON_SIZE} pixels')
+ return data
+
+
def bundle_name(version, target):
return f'graphicle-{version}-{target}.mcpb'
@@ -200,6 +219,7 @@ def manifest(version, target):
'homepage': f'https://github.com/{REPOSITORY}',
'documentation': f'https://github.com/{REPOSITORY}/blob/v{version}/docs/mcp.md',
'support': f'https://github.com/{REPOSITORY}/issues',
+ 'icon': 'icon.png',
'server': {
'type': 'binary',
'entry_point': f'server/{program}',
@@ -257,7 +277,8 @@ def build(archive, version, out):
fail(f'{archive.name} has no {", ".join(missing)} in {root}/')
mtime, binary = files[program]
text = json.dumps(manifest(version, target), indent=2, ensure_ascii=False) + '\n'
- entries = [('manifest.json', 0o644, text.encode('utf-8')), (f'server/{program}', 0o755, binary)]
+ entries = [('manifest.json', 0o644, text.encode('utf-8')), (f'server/{program}', 0o755, binary),
+ ('icon.png', 0o644, icon())]
# Every other file is a document, 0644 whatever the archive says.
entries += [(name, 0o644, files[name][1]) for name in (*LEGAL, *LEGAL_EXTRA) if name in files]
entries += [(name, 0o644, data) for name, (_, data) in sorted(files.items()) if name.startswith(LICENCES)]
diff --git a/packaging/mcpb/icon.png b/packaging/mcpb/icon.png
new file mode 100644
index 0000000..ef8c185
Binary files /dev/null and b/packaging/mcpb/icon.png differ
diff --git a/packaging/mcpb/icon.svg b/packaging/mcpb/icon.svg
new file mode 100644
index 0000000..91aaca2
--- /dev/null
+++ b/packaging/mcpb/icon.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 128 128"><title>Graphicle</title><defs><linearGradient id="ag225" gradientUnits="userSpaceOnUse" x1="16" y1="112" x2="112" y2="16"><stop offset="0" stop-color="#5B7CFF"/><stop offset="1" stop-color="#22D3EE"/></linearGradient><linearGradient id="al226" gradientUnits="userSpaceOnUse" x1="54.03" y1="41.79" x2="55.63" y2="53.4"><stop offset="0" stop-color="#36b4f4"/><stop offset="1" stop-color="#A78BFA"/></linearGradient><linearGradient id="al227" gradientUnits="userSpaceOnUse" x1="93.22" y1="87.43" x2="79.8" y2="82.8"><stop offset="0" stop-color="#3aaff5"/><stop offset="1" stop-color="#A78BFA"/></linearGradient><linearGradient id="al228" gradientUnits="userSpaceOnUse" x1="32.56" y1="93.69" x2="40.35" y2="88.27"><stop offset="0" stop-color="#5881fe"/><stop offset="1" stop-color="#A78BFA"/></linearGradient><radialGradient id="bg" cx="64" cy="64" r="90.51" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#282c50"/><stop offset="0.15" stop-color="#222645"/><stop offset="0.4" stop-color="#161a30"/><stop offset="0.7" stop-color="#0f121f"/><stop offset="1" stop-color="#0c0e16"/></radialGradient></defs><rect width="128" height="128" fill="url(#bg)"/><g transform="translate(64 64) scale(0.84) translate(-64 -64)"><path d="M63.11 37.74L98.56 79.63" fill="none" stroke="url(#ag225)" stroke-width="10" stroke-linecap="round"/><path d="M92.36 95.29L35.64 101.83" fill="none" stroke="url(#ag225)" stroke-width="10" stroke-linecap="round"/><path d="M24.86 87.45L44.66 40.55" fill="none" stroke="url(#ag225)" stroke-width="10" stroke-linecap="round"/><path d="M55.63 53.4L54.03 41.79" fill="none" stroke="url(#al226)" stroke-width="10" stroke-linecap="round"/><path d="M79.8 82.8L93.22 87.43" fill="none" stroke="url(#al227)" stroke-width="10" stroke-linecap="round"/><path d="M40.35 88.27L32.56 93.69" fill="none" stroke="url(#al228)" stroke-width="10" stroke-linecap="round"/><circle cx="51.59" cy="24.12" r="9.5" fill="url(#ag225)"/><circle cx="110.08" cy="93.24" r="9.5" fill="url(#ag225)"/><circle cx="17.92" cy="103.88" r="9.5" fill="url(#ag225)"/><circle cx="58.68" cy="75.52" r="14" fill="#A78BFA"/></g></svg>
diff --git a/packaging/mcpb/render_server_json.py b/packaging/mcpb/render_server_json.py
index 10857a7..322ba53 100755
--- a/packaging/mcpb/render_server_json.py
+++ b/packaging/mcpb/render_server_json.py
@@ -10,7 +10,10 @@ v<version>), with the file's SHA-256, which MCP clients check before they
install a bundle, and stdio transport. The registry has no field for a
package's platform: the file names carry the target, each bundle's manifest
names its operating system, and the packages are listed with the most common
-machine of each system first.
+machine of each system first. The entry's icon is the bundles' icon.png, by its
+address on raw.githubusercontent.com in the commit the GitHub Actions run
+checked out, which stays the same when main moves on (outside GitHub Actions,
+the address names main).
The namespace io.github.Graphicle-AI is spelled as GitHub spells the
organization: the registry grants a GitHub Actions run of this repository the
@@ -27,7 +30,8 @@ import zipfile
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parent))
-from build_mcpb import DESCRIPTION, REPOSITORY, TARGETS, VERSION, bundle_name, fail, program_name, sha256 # noqa: E402
+from build_mcpb import (DESCRIPTION, ICON, ICON_SIZE, REPOSITORY, TARGETS, VERSION, bundle_name, fail, # noqa: E402
+ icon, program_name, sha256)
SCHEMA = 'https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json'
OWNER = REPOSITORY.split('/')[0]
@@ -40,6 +44,8 @@ REPOSITORY_ID = '1418870464'
NAME_PATTERN = re.compile(r'[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+')
RELEASE_ASSET = re.compile(r'https://github\.com/[a-zA-Z0-9]([a-zA-Z0-9-]{0,37}[a-zA-Z0-9])?/[a-zA-Z0-9._-]+'
r'/releases/download/[^/]+/[^/]+')
+# The commit a GitHub Actions run checked out, whose icon the entry links to.
+COMMIT = re.compile(r'[0-9a-f]{40}')
def check_run():
@@ -55,6 +61,8 @@ def check_run():
fail(f'this run belongs to {os.environ.get("GITHUB_REPOSITORY")}, not {REPOSITORY}')
if os.environ.get('GITHUB_REPOSITORY_ID', REPOSITORY_ID) != REPOSITORY_ID:
fail(f'the repository id is {os.environ["GITHUB_REPOSITORY_ID"]}, not {REPOSITORY_ID}')
+ if not COMMIT.fullmatch(os.environ.get('GITHUB_SHA', '')):
+ fail(f'GITHUB_SHA {os.environ.get("GITHUB_SHA")!r} is not a commit id')
def package(bundles, version, target):
@@ -87,6 +95,18 @@ def package(bundles, version, target):
}
+def icons():
+ """The entry's icon: the file every bundle holds, by its address in the
+ run's commit, or on main outside GitHub Actions. The registry takes an
+ HTTPS address of at most 255 characters."""
+ icon()
+ commit = os.environ['GITHUB_SHA'] if os.environ.get('GITHUB_ACTIONS') == 'true' else 'main'
+ url = f'https://raw.githubusercontent.com/{REPOSITORY}/{commit}/{ICON}'
+ if len(url) > 255:
+ fail(f'{url} is longer than the registry allows')
+ return [{'src': url, 'mimeType': 'image/png', 'sizes': [f'{ICON_SIZE}x{ICON_SIZE}']}]
+
+
def server_json(bundles, version):
if not NAME_PATTERN.fullmatch(NAME) or len(NAME) > 200:
fail(f'{NAME} is not a server name the registry accepts')
@@ -99,6 +119,7 @@ def server_json(bundles, version):
'description': DESCRIPTION,
'version': version,
'websiteUrl': f'https://github.com/{REPOSITORY}/blob/v{version}/docs/mcp.md',
+ 'icons': icons(),
'repository': {'url': f'https://github.com/{REPOSITORY}', 'source': 'github', 'id': REPOSITORY_ID},
'packages': [package(bundles, version, target) for target in TARGETS],
}