{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_swhysbxw2rkm","handle":"modelscope-image-mcp","url":"https://wellknown.network/agents/modelscope-image-mcp","links":{"self":"https://wellknown.network/agents/modelscope-image-mcp/record.json","html":"https://wellknown.network/agents/modelscope-image-mcp","markdown":"https://wellknown.network/agents/modelscope-image-mcp/record.md","api":"https://wellknown.network/api/v1/agents/modelscope-image-mcp","status":"https://wellknown.network/api/v1/agents/modelscope-image-mcp/status","claim":"https://wellknown.network/agents/modelscope-image-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/modelscope-image-mcp/claim.json","badge":"https://wellknown.network/agents/modelscope-image-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/modelscope-image-mcp/history","tools":"https://wellknown.network/api/v1/agents/modelscope-image-mcp/tools"},"ard":{"identifier":"urn:air::server:modelscope-image-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"modelscope-image-mcp","summary":"MCP Server for ModelScope Qwen-Image text-to-image generation","description":"# ModelScope Image MCP Server\n\nEnglish | [中文](README-zh.md)\n\nAn MCP (Model Context Protocol) server for generating images via the ModelScope image generation API. This server provides seamless integration with AI assistants, enabling them to create images through natural language prompts with robust async processing and local file management.\n\n> IMPORTANT: Earlier drafts of this README mentioned features like returning base64 data, negative prompts, and additional parameters. The current released code (see `src/modelscope_image_mcp/server.py`) implements a focused minimal feature set: one tool `generate_image` that submits an async task and saves the resulting image locally. Planned / upcoming features are listed in the roadmap below.\n\n## Current Features\n\n- Asynchronous image generation using ModelScope async task API\n- Periodic task status polling (every 5 seconds, up to 2 minutes)\n- Saves the first generated image to a local file\n- Returns task status and image URL to the MCP client\n- Robust error handling + timeout messaging\n- Simple one-command start with `uvx`\n\n## Environment Variable\n\nThe server reads your credential from:\n\n```\nMODELSCOPE_SDK_TOKEN\n```\n\nIf it is missing, the server will raise an error. Obtain a token from: https://modelscope.cn/my/myaccesstoken\n\n### Set on Windows (cmd):\n```\nset MODELSCOPE_SDK_TOKEN=your_token_here\n```\nPowerShell:\n```\n$env:MODELSCOPE_SDK_TOKEN=\"your_token_here\"\n```\nUnix/macOS bash/zsh:\n```\nexport MODELSCOPE_SDK_TOKEN=your_token_here\n```\n\n## Installation & MCP Client Configuration\n\nYou can register the server directly in an MCP-compatible client (e.g. Claude Desktop) without a prior manual install thanks to `uvx`.\n\n### Option 1: PyPI (Recommended once published)\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"modelscope-image\": {\n      \"command\": \"uvx\",\n      \"args\": [\"modelscope-image-mcp\"],\n      \"env\": {\n        \"MODELSCOPE_SDK_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\n### Option 2: Direct from GitHub\n\n```jsonc\n{\n  \"mcpServers…","publisher":null,"homepage":"https://github.com/zym9863/modelscope-image-mcp","repository":"https://github.com/zym9863/modelscope-image-mcp/issues","version":"1.1.0","license":"MIT License\n        \n        Copyright (c) 2025 zym9863\n       …","protocols":["mcp"],"tags":["ai","generation","image","mcp","modelscope","qwen"],"pricing":null,"endpoints":[{"url":"pypi:modelscope-image-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"media.image-generation","name":"Image Generation","confidence":1,"provenance":"derived"},{"slug":"code.generation","name":"Code Generation","confidence":1,"provenance":"declared"}],"categories":["code","media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"modelscope-image-mcp","registry":"pypi","observedAt":"2026-10-22T13:23:55.845Z","publishedAt":"2025-09-24T07:35:57.723810Z","latestVersion":"1.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"modelscope-image-mcp","url":"https://pypi.org/project/modelscope-image-mcp/","firstSeenAt":"2026-09-10T06:23:36.520Z","fetchedAt":"2026-10-22T13:22:36.775Z","normalizedAt":"2026-10-22T13:22:36.775Z"}]},"firstSeenAt":"2026-09-10T06:23:36.520Z","updatedAt":"2026-10-22T13:23:55.845Z"}