codesign-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CODESIGN_IDLE_MS | No | Idle time in milliseconds before browser shutdown (default: 600000). | |
| CODESIGN_DATA_DIR | No | Override the .codesign-mcp data directory path. | |
| CODESIGN_LOG_FILE | No | Override the log file path. If set, the parent directory is created automatically. | |
| CODESIGN_LOG_LEVEL | No | Log level (e.g., 'info', 'debug', 'error'). | |
| CODESIGN_PROFILE_DIR | No | Override the Chromium profile directory path. | |
| CODESIGN_KEEP_BROWSER | No | Set to '1' to keep the browser open between requests. | |
| CODESIGN_ARTIFACTS_DIR | No | Override the artifacts directory path. | |
| CODESIGN_WORKSPACE_DIR | No | The workspace directory for storing runtime files. If not set, uses INIT_CWD or process.cwd(). |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| implement_codesign_page | Generate 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
| Name | Description |
|---|---|
| design-to-code-workflow | Read-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