Code graph and memory for your coding agents, in one Rust program. For Claude Code, Codex, Cursor and any MCP client.
Rust agent-memoryai-agentsclaude-codecode-analysiscode-graphcode-intelligencecode-searchcodexcoding-agentscontext-engineeringcursordeveloper-toolsgraphragknowledge-graphlocal-firstmcpmcp-servermodel-context-protocolrusttree-sitter
MCP bundles and the registry entry show the Graphicle icon
VikramLexfa8d3e422e04
diff --git a/.github/workflows/mcp-registry.yml b/.github/workflows/mcp-registry.ymlindex 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):"echodiff --git a/CHANGELOG.md b/CHANGELOG.mdindex a55c539..1038978 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -3,6 +3,15 @@Notable changes to Graphicle: the graph engine (`graphicle-graph`), the memorylibrary (`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-18Every crate is at 0.1.2, and `graphicle --version` printsdiff --git a/packaging/mcpb/README.md b/packaging/mcpb/README.mdindex 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 thegraph 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 timediff --git a/packaging/mcpb/build_mcpb.py b/packaging/mcpb/build_mcpb.pyindex 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 holdsserver/ the archive's program, graphicle (graphicle.exe onWindows), 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+ serverLICENSE, NOTICE, NOTICE.md and licenses/the archive's licence and notices, which go wherever theprogram goes@@ -37,6 +40,7 @@ import jsonimport osimport reimport stat+import structimport sysimport tarfileimport 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.pngnew file mode 100644index 0000000..ef8c185Binary files /dev/null and b/packaging/mcpb/icon.png differdiff --git a/packaging/mcpb/icon.svg b/packaging/mcpb/icon.svgnew file mode 100644index 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.pyindex 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 theyinstall a bundle, and stdio transport. The registry has no field for apackage's platform: the file names carry the target, each bundle's manifestnames 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 theorganization: the registry grants a GitHub Actions run of this repository the@@ -27,7 +30,8 @@ import zipfilefrom pathlib import Pathsys.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],}