Skip to main content
Glama
ccpopy

codesign-mcp

by ccpopy

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CODESIGN_IDLE_MSNoIdle time in milliseconds before browser shutdown (default: 600000).
CODESIGN_DATA_DIRNoOverride the .codesign-mcp data directory path.
CODESIGN_LOG_FILENoOverride the log file path. If set, the parent directory is created automatically.
CODESIGN_LOG_LEVELNoLog level (e.g., 'info', 'debug', 'error').
CODESIGN_PROFILE_DIRNoOverride the Chromium profile directory path.
CODESIGN_KEEP_BROWSERNoSet to '1' to keep the browser open between requests.
CODESIGN_ARTIFACTS_DIRNoOverride the artifacts directory path.
CODESIGN_WORKSPACE_DIRNoThe workspace directory for storing runtime files. If not set, uses INIT_CWD or process.cwd().

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
codesign_statusA

Return MCP server config (profile path, idle settings) and current browser/login status. Use this first to verify whether the user has logged in.

codesign_loginA

Open a visible Chromium window pointed at codesign.qq.com so the user can scan-login. If already logged in, returns immediately without opening a window. The session is persisted under profileDir and reused by subsequent tools.

codesign_logoutA

Close any running browser and wipe the persistent profile directory. Pass { confirm: true }. The target path is included in the result so the caller can verify before re-running.

list_artboardsA

Use this first when a task contains a CoDesign sharing URL or asks to implement/recreate a CoDesign design. It resolves the official CoDesign sharing data into designs and screens with id, object_id, name, size, image URLs, meta_url, and slices_url. For design-to-code work, select a screen from this result before calling get_artboard_spec. Do not infer screens by cropping preview images.

get_artboard_specA

Canonical CoDesign source for design-to-code: fetches the official meta_url JSON with layer positions, text, fills, colors, CSS, groups, and slice manifest. Returns raw CoDesign fields; when css and fills disagree, inspect both fields and the screenshot instead of assuming one is always authoritative. Use this before writing HTML/CSS from a CoDesign URL. Do not crop or OCR preview screenshots when this tool can return the spec. Selector precedence: screenId > objectId > screenName. Multiple screens without a selector return SCREEN_SELECTOR_REQUIRED with options. includeSlices defaults to true so available designer-exported slice metadata is returned with the spec.

get_artboard_imageA

Returns the CoDesign preview or cover image for visual comparison only. For implementation, prefer get_artboard_spec for layout/text/CSS and download_slice for designer-exported assets; do not crop this preview image to create production slices. When download=true, stores the image under /.codesign-mcp/artifacts//screens/. Selector precedence: screenId > objectId > screenName.

download_sliceA

Downloads designer-exported CoDesign slice assets from the official slice manifest, matched by layer object_id. Use this for implementation assets instead of using Python/PIL or screenshot cropping. Returns local paths under /.codesign-mcp/artifacts//slices/. Optional filters: format and scales.

debug_collect_networkA

Open the sharing page in a headless browser, record all network responses for timeoutMs, and return a REDACTED summary. Use this to discover unknown endpoints or to debug why a tool fails. Output never contains Cookie, Authorization, password, state-key values, or response bodies — only JSON key paths.

Prompts

Interactive templates invoked by user choice

NameDescription
implement_codesign_pageGenerate a design-to-code workflow prompt that uses list_artboards, get_artboard_spec, and download_slice in order.

Resources

Contextual data attached and managed by the client

NameDescription
design-to-code-workflowRead-only workflow guidance for using codesign-mcp tools to implement pages from Tencent CoDesign sharing links.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ccpopy/codesign-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server