Skip to main content
Glama

ArtForge AI MCP

License: Apache-2.0 Node.js >= 20 MCP

العربية · English

مولّد الصور المدمج · Integrated image generator

ArtForge يتضمن مولّد صور عصبيًا مدمجًا يستخدم FLUX.2 Klein 4B من Black Forest Labs، ويشغّله Cloudflare Workers AI. المولد ليس نموذجًا مدرّبًا من الصفر بواسطة OBR ولا يعمل على GPU خادم Render؛ يحافظ ArtForge على محرك Skia والقوالب والخطوط العربية ومسار التحرير القائم.

The integrated generator uses FLUX.2 Klein 4B, hosted by Cloudflare Workers AI. The public MCP gateway exposes artforge_generate_image with asynchronous submit/get/cancel/delete actions, durable idempotency and connection-scoped ownership. Text-only generation runs independently of Render cold starts; drawing-based generation first retrieves the actual owned drawing from the renderer.

ارسم ثم ولّد · Draw, then generate

ارسم بمحرك ArtForge أولًا، ثم مرّر documentId إلى المولّد مع وصف التحويل. يستقبل FLUX صورة الرسم الفعلية في input_image_0، مثل تحويل المشهد الكرتوني إلى مظهر ثلاثي الأبعاد. تعرض النتيجة بصمة المرجع source.referenceSha256 للتحقق. الرسم الأصلي لا يتغير؛ المظهر ثلاثي الأبعاد صورة نقطية وليس نموذج 3D قابلًا للتحرير.

First create a drawing with artforge_create_design. Then submit its documentId to artforge_generate_image, alongside the transformation instruction. FLUX receives the actual renderer PNG as image 0, not just another description. Both the local owner adapter and the public gateway support this workflow. See the reference contract.

{"action":"submit","operationId":"cabin-3d-unique","documentId":"doc_example","prompt":"Transform image 0 into a warm 3D cartoon. Preserve its composition, two armchairs, fireplace and open book.","width":512,"height":512}

Poll {"action":"get","jobId":"<returned jobId>"} until succeeded. The drawing must belong to the same OAuth connection. References are reduced below 512px; exact text and geometry are not guaranteed. Cached clients can use artforge_tool_op with op:"generation.jobs.submit" and params:{version:1,...}.

  • الرابط العام / Public MCP: https://artforge-mcp-gateway.obr432.workers.dev/mcp.

  • المسار العام: صور نقطية 256–512px، حتى 3 طلبات لكل اتصال في اليوم UTC، وحصة يومية مشتركة مقدرة لا تتجاوز 900 Neurons. لا إعادة تلقائية للتوليد؛ تنتهي الصور المحفوظة بعد 24 ساعة.

  • Public output is raster, not editable vectors. Exact editable Arabic overlays and saved projects are verified in the separate DEV integration; the public generator returns a standalone image in the chat.

  • للاطلاع على التنفيذ: public gateway and quotas، DEV integration. Optional DEV generation requires Node.js 24; the basic renderer remains compatible with Node.js 20+.

  • Owner-managed local installation: optional artforge-mcp/data/owner-generation.json enables the existing artforge_tool_op operation generation.generate using Wrangler OAuth stored by Cloudflare. This local path uses a separate persistent 900-Neuron daily reservation cap, requires Node.js 24, and never accepts credentials or provider URLs from an MCP request. See owner configuration.

  • Model weights are not included. Cloudflare service terms and model terms apply separately from the repository's Apache-2.0 code license.


Related MCP server: Rayzia MCP

العربية

ArtForge AI MCP محرّك رسم وتصميم ثنائي الأبعاد مفتوح المصدر، صُمّم للعربية أولًا، ويُتاح لوكلاء الذكاء الاصطناعي عبر بروتوكول MCP. مشروع من مجموعة OBR Group الرقمية.

لماذا ArtForge؟

  • دعم أصيل للغة العربية: تشكيل الحروف ووصلها، واتجاه من اليمين إلى اليسار مع عزل كل سطر عربي، ومحاذاة صحيحة لعلامات الترقيم، مع خطوط عربية مرفقة (أميري، تجوّل، المراعي).

  • جودة رسوم عالية: عرض متجهي بمحرّك Skia مع تنعيم الحواف، وتدرجات لونية، وطبقات، وأنماط مزج، وظلال وتوهج، وفُرش رسم، وتصدير PNG وJPEG وWebP.

  • تصميم بأمر واحد: يفهم الأداة artforge_create_design الطلب ويكتشف نوع التصميم (بطاقة، ملصق، جدول، صفحة مسطّرة، مشهد، شخصية…)، ثم يخطط ويرسم ويُصدّر ويفحص النتيجة بكسليًا ويعيد معاينة.

  • تعديلات دقيقة: عمليات رسم أساسية (draw.rect، draw.text، draw.path، draw.gradient، draw.brush…) فرديًا أو دفعة واحدة.

  • آمن للاستضافة: خادم الرسم يمنع الوصول لملفات المضيف واختيار مزوّدات عشوائية؛ والمولّد المدمج متاح عبر البوابة العامة، وتحدّ الأبعاد بـ 1600 بكسل لكل ضلع، وتعالج طلبًا واحدًا في كل مرة.

ربط المكوّن بأي وكيل

صفحة المطوّر ورابط الخادم المستضاف لربط المكوّن مباشرة بأي وكيل يدعم MCP: https://obr.obr432.workers.dev/ai-plugins/#connect

أو شغّل الخادم محليًا كما يلي، ثم أضف العنوان http://127.0.0.1:4273/mcp إلى عميل MCP (نقل HTTP).

التثبيت والتشغيل

المتطلبات: Node.js 20 أو أحدث (اختُبر على Node.js 24).

git clone https://github.com/duhbobaldo-oss/artforge-mcp-trial.git
cd artforge-mcp-trial
npm run setup      # يثبّت اعتمادية محرّك الرسم (@napi-rs/canvas)
npm start          # يبدأ الخادم على http://127.0.0.1:4273/mcp
npm test           # اختبار تشغيل شامل: تهيئة MCP، تصميم عربي، تصدير PNG، وقيود النسخة
  • GET /health يعيد {"ok":true}.

  • POST /mcp يستقبل رسالة JSON-RPC واحدة بترويسة Content-Type: application/json وبترميز UTF-8 (في سطر أوامر Windows احفظ الطلب في ملف UTF-8 وأرسله بـ curl --data-binary @request.json حتى لا يتحوّل النص العربي إلى مربعات فارغة).

  • محليًا (127.0.0.1) لا يُطلب رمز. للربط على واجهة شبكة عامة يجب تقديم ملف رمز عبر ARTFORGE_DEMO_TOKEN_FILE (من 32 إلى 128 حرفًا من A-Z a-z 0-9 _ -)، ويرسل العميل Authorization: Bearer <token>.

  • النشر عبر Docker وRender موضّح في docs/trial-deployment.md.

الأدوات المتاحة

الأداة

الوظيفة

artforge_create_design

ينشئ تصميمًا كاملًا من وصف نصي ويعيد المعاينة ونتائج الفحص

artforge_plan_design / artforge_execute_design

تخطيط التصميم ثم تنفيذه على مرحلتين

artforge_tool_op

عمليات draw.* الأساسية، أو batch لعدة عمليات، وقراءة المستند ومعاينته

artforge_export

تصدير PNG أو JPEG أو WebP

artforge_tool_docs

إجراء التشغيل، ودليل المهارات، وتوجيه الطلب للمهارة المناسبة

artforge_capabilities / artforge_status / artforge_artifacts

القدرات والحالة والملفات الناتجة

artforge_get_reference / artforge_book_knowledge

لوحة الألوان ونظام التصميم المرفقان، والمعرفة المرجعية

بنية المستودع

المسار

المحتوى

server.js

خادم HTTP لبروتوكول MCP، مع قيود الأمان والأبعاد

artforge-mcp/

وحدة MCP: التخطيط، وموجّه المهارات، والمهارات (skills/)، والجسر إلى محرّك الرسم

drawing-tool/

محرّك الرسم والخطوط العربية المرفقة وتراخيصها

docs/

توثيق العمليات والخطوط والتصدير والحدود (docs/README.md)

test/

اختبار التشغيل الشامل

المساهمة والترخيص

نرحّب بالمساهمات؛ اقرأ CONTRIBUTING.md. المشروع مرخّص بموجب Apache License 2.0، والخطوط المرفقة بموجب SIL Open Font License 1.1. التفاصيل في THIRD_PARTY_NOTICES.md.


English

ArtForge AI MCP is an open-source, Arabic-first 2D drawing and design engine that AI agents use through the Model Context Protocol (MCP). It is an OBR Group project.

Highlights

  • Native Arabic support: correct letter shaping and joining, right-to-left layout with per-line bidi isolation, proper punctuation placement, and bundled Arabic fonts (Amiri, Tajawal, Almarai).

  • High-quality graphics: anti-aliased vector rendering on Skia, gradients, layers, blend modes, shadows and glows, brush strokes, and PNG / JPEG / WebP export.

  • One-call design: artforge_create_design reads the request, detects the design type (card, poster, table, ruled page, scene, character, …), plans, draws, exports, runs pixel QA and returns a preview.

  • Precise edits: primitive operations (draw.rect, draw.text, draw.path, draw.gradient, draw.brush, …) one at a time or as a batch.

  • Safe to host: the renderer blocks host-file access and arbitrary providers; the integrated image generator is exposed by the public gateway, caps canvases at 1600 px per side, and serves one request at a time.

Connect it to any agent

Developer page and hosted server URL for connecting ArtForge directly to any MCP-capable agent: https://obr.obr432.workers.dev/ai-plugins/#connect

Or run the server locally (below) and add http://127.0.0.1:4273/mcp to your MCP client as an HTTP server.

Install and run

Requirements: Node.js 20 or later (tested on Node.js 24).

git clone https://github.com/duhbobaldo-oss/artforge-mcp-trial.git
cd artforge-mcp-trial
npm run setup      # installs the drawing-engine dependency (@napi-rs/canvas)
npm start          # serves MCP at http://127.0.0.1:4273/mcp
npm test           # end-to-end smoke test: MCP handshake, Arabic design, PNG export, trial limits
  • GET /health returns {"ok":true}.

  • POST /mcp accepts one JSON-RPC message with Content-Type: application/json.

  • On 127.0.0.1 no token is required. Binding to a public interface requires a token file via ARTFORGE_DEMO_TOKEN_FILE (32–128 characters of A-Z a-z 0-9 _ -); clients send Authorization: Bearer <token>.

  • Environment variables: HOST (default 127.0.0.1), PORT (default 4273), ARTFORGE_DEMO_TOKEN_FILE.

  • Docker and Render deployment: docs/trial-deployment.md.

Example request:

curl -s http://127.0.0.1:4273/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"artforge_create_design","arguments":{"prompt":"بطاقة ترحيب","headline":"مرحبًا بالعربية","width":900,"height":480}}}'

Requests must be UTF-8. On Windows shells, non-ASCII command-line arguments can be re-encoded and Arabic then renders as empty boxes; save the JSON to a UTF-8 file and send it with curl --data-binary @request.json instead.

Tools

Tool

Purpose

artforge_create_design

Build a complete design from a prompt; returns preview and QA results

artforge_plan_design / artforge_execute_design

Two-step plan, then execute

artforge_tool_op

Primitive draw.* operations, batch, document info and preview

artforge_export

Export PNG, JPEG or WebP

artforge_tool_docs

Operating procedure, skill guides and request routing

artforge_capabilities / artforge_status / artforge_artifacts

Capabilities, status and generated files

artforge_get_reference / artforge_book_knowledge

Bundled palette and design system, reference knowledge

Repository layout

Path

Contents

server.js

HTTP MCP server with security and size limits

artforge-mcp/

MCP module: planner, skill router, skills (skills/), drawing-engine bridge

drawing-tool/

Drawing engine, bundled Arabic fonts and their licenses

docs/

Operations, fonts, export and limits documentation (docs/README.md)

test/

End-to-end smoke test

Contributing and license

Contributions are welcome — see CONTRIBUTING.md. Licensed under the Apache License 2.0. Bundled fonts are under the SIL Open Font License 1.1; see THIRD_PARTY_NOTICES.md.

© OBR Group

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to drive a live SVG/vector editor, allowing a full observe-and-act loop on a canvas with real tools, state reading, and PNG rendering.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to convert natural-language briefs into structured visual specs, deterministically render typography and layouts, and run constraint-aware visual QA and targeted repair for image generation.
      41 npm
      Apache 2.0