ModelScope API Skill — 模型Scope API 技能

魔塔社区（模型Scope）API 完整手册 概述

本 技能 封装魔塔社区全部可用 API，包括：模型库、数据集、技能中心（80K+ 技能）、MCP 广场（9.4K+ 服务器）。支持令牌自动引导注册。

两种响应格式注意：

/API/v1/（旧）：PascalCase → {"Code": 200, "Data": {...}} /openAPI/v1/（新）：snake_case → {"成功": true, "data": {...}} 第一步：令牌 设置（首次使用必读） 情况 A：已有 令牌

设置环境变量或在每次请求加 Header：

导出 模型SCOPE_API_令牌="ms-xxxxxx"

请求头格式：Authorization: Bearer {令牌}

情况 B：没有 令牌 → 引导注册

请按以下步骤获取 令牌：

打开注册页面：https://www.模型scope.cn/my/overview 用手机号/支付宝/钉钉完成注册登录 登录后，点右上角头像 → 「访问令牌」(访问 令牌) 点「新建令牌」，填写名称（如 workbuddy），权限选「全部」 复制生成的 令牌（格式：ms-xxxxxx），只显示一次，务必保存

⚠️ 令牌 即密码，不要提交到 GitHub。建议写入 ~/.模型scope/令牌 文件。

获取 令牌 后，告诉 AI：「我的魔塔 令牌 是 ms-xxxxxx」，AI 会帮你配置。

能力一：技能中心（技能s）

总技能数：80,505+

1.1 搜索/列出技能 curl -s "https://www.模型scope.cn/openAPI/v1/技能s?page_number=1&page_size=10&搜索=股票" | python -m json.工具

查询 参数：

参数 类型 说明 page_number int 页码，默认 1 page_size int 每页数量，默认 10 搜索 string 搜索关键词（匹配 display_name）

无需 令牌 即可访问。

响应示例：

{ "成功": true, "data": { "total": 80505, "技能s": [ { "id": "@Alipay/alipay-payment-integration", "display_name": "支付宝支付集成技能", "description": "...", "category": "developer-工具s", "view_count": 21881, "下载s": 2069 } ] } }

1.2 获取技能详情（含安装命令） curl -s "https://www.模型scope.cn/openAPI/v1/技能s/@Alipay/alipay-payment-integration" | python -m json.工具

返回额外字段 安装_command（3 种安装方式）：

{ "安装_command": [ "npx 技能s 添加 https://模型scope.cn/技能s/@Alipay/alipay-payment-integration", "curl -fsSL https://模型scope.cn/技能s/安装.sh | bash -s -- @Alipay/alipay-payment-integration", "pip 安装 --升级 模型scope && 模型scope 技能s 添加 @Alipay/alipay-payment-integration" ] }

1.3 下载技能（需 令牌） from 模型scope.hub.API 导入 HubAPI

API = HubAPI(令牌="ms-xxxxxx") 技能_dir = API.下载_技能(技能_id="@Alipay/alipay-payment-integration") print(f"技能已下载到: {技能_dir}")

底层 API（一般不直接调用）：

获取 /API/v1/技能s/{path}/{name}/归档/zip/master Header: Cookie: m_会话_id={令牌}

1.4 技能分类列表 分类 ID 说明 developer-工具s 开发工具 AI-media AI 媒体 技能-management 技能管理 cloud-devops 云 DevOps frontend-development 前端开发 code-质量-测试 代码质量测试 marketing-seo 营销 SEO AI-自动化 AI 自动化 doc-processing 文档处理 能力二：MCP 广场

总 MCP 服务器数：9,477+

2.1 搜索/列出 MCP 服务器 curl -s -X PUT "https://www.模型scope.cn/openAPI/v1/mcp/servers" \ -H "Content-Type: 应用/json" \ -d '{"过滤器": {"category": "developer-工具s"}, "page_number": 1, "page_size": 10, "搜索": ""}' | python -m json.工具

Body 参数：

参数 类型 说明 过滤器.category string 分类过滤（见下方分类表） 过滤器.tag string 标签过滤 过滤器.is_hosted bool 是否只查托管服务器 page_number int 页码，默认 1 page_size int 每页数量，最大 100，默认 20 搜索 string 搜索（匹配中文名/英文名/作者）

过滤器 中的多个条件取交集；搜索 与 过滤器 可组合使用。

无需 令牌 即可访问列表。

响应示例：

{ "成功": true, "data": { "total_count": 9477, "mcp_server_列出": [ { "id": "@模型上下文protocol/fetch", "name": "Fetch网页内容抓取", "chinese_name": "Fetch网页内容抓取", "description": "该服务器使大型语言模型能够检索和处理网页内容...", "categories": ["browser-自动化"], "view_count": 457094 } ] } }

2.2 获取 MCP 服务器详情（含配置） curl -s "https://www.模型scope.cn/openAPI/v1/mcp/servers/@模型上下文protocol/fetch?获取_operational_url=true" | python -m json.工具

返回关键字段：

字段 说明 server_config MCP 客户端配置（command + args），直接用于 mcp.json readme 服务器说明文档（Markdown） is_hosted 是否已触发托管服务 is_verified 是否官方认证 env_模式 环境变量 JSON 模式（如需配置 API Key） source_url 源码地址（通常是 GitHub） github_stars GitHub 星标数

server_config 示例（直接复制到 MCP 客户端配置）：

{ "mcpServers": { "fetch": { "command": "uvx", "args": ["mcp-server-fetch"] } } }

2.3 获取用户运行中的 MCP 服务器（需 令牌） curl -s "https://www.模型scope.cn/openAPI/v1/mcp/servers/operational" \ -H "Authorization: Bearer ms-xxxxxx" | python -m json.工具

⚠️ 此端点必须传 令牌，否则返回 401。

2.4 MCP 分类列表（27 个） 分类 ID 说明 分类 ID 说明 AI-gc AI 生成 browser-自动化 浏览器自动化 communication 通讯 content-management-系统s 内容管理 databases 数据库 data-平台s 数据平台 developer-工具s 开发工具 entertAInment-and-media 娱乐媒体 finance 金融 file-系统s 文件系统 image-and-video-processing 图像视频 knowledge-and-memory 知识记忆 location-服务s 位置服务 监控ing 监控 note-taking 笔记 other 其他 os-自动化 系统自动化 re搜索-and-data 研究数据 搜索 搜索 travel-and-transportation 出行交通 version-control 版本控制 cloud-平台s 云平台 art-and-culture 艺术文化 calendar-management 日历管理 能力三：模型库（模型s）

总模型数：194,001+

3.1 列出模型 curl -s -X PUT "https://www.模型scope.cn/API/v1/模型s" \ -H "Authorization: Bearer ms-xxxxxx" \ -H "Content-Type: 应用/json" \ -d '{"page_number": 1, "page_size": 10, "搜索": "llama"}' | python -m json.工具

⚠️ 模型 API 使用旧格式（/API/v1/，PascalCase）

响应格式：

{ "Code": 200, "成功": true, "Data": { "TotalCount": 194001, "模型s": [...] } }

3.2 获取模型详情 curl -s "https://www.模型scope.cn/API/v1/模型s/{owner}/{name}" \ -H "Authorization: Bearer ms-xxxxxx" | python -m j