Dotmira

俄语版： README.ru.md · 网站文档： https://dotmira.com/en/developers · 注册表条目： registry/

Dotmira MCP 服务和 API

Dotmira 提供 API，包含两种程序化接口：供 AI 助手、AI Agent 和代码编辑器使用的 MCP 服务，支持 Claude、ChatGPT、Cursor、VS Code 及其他 MCP 客户端；以及兼容 shadcn 的组件注册表，可通过命令行安装。助手会在目录中找到合适的网页特效、动画或 UI 组件，并获取其代码、作者、来源和许可证信息。

账户 → MCP 和注册表

概览

内容	值
MCP 服务	https://dotmira.com/mcp — 远程服务，无需安装
协议	基于 Streamable HTTP 的 Model Context Protocol（MCP）；规范版本 2026-07-28，较早版本的客户端也可以连接
登录	OAuth 2.1（使用 Dotmira 账户登录）或个人令牌（Authorization: Bearer dtm_…）
工具	search_effects、get_effect、list_categories、get_preview — 只读
注册表	https://dotmira.com/r/{name}.json，命名空间 @dotmira，shadcn 注册表格式
目录	超过 31,000 种网页特效、动画、UI 组件和模板：React、Tailwind、HTML/CSS、TypeScript、Vue
不提供	REST 或 GraphQL API、SDK、OpenAPI 描述、自有 CLI

MCP 服务

该服务通过 Streamable HTTP 使用开放的 Model Context Protocol（MCP）。这是一个远程服务：无需安装，只需服务地址并登录即可。

服务地址

• dotmira.com https://dotmira.com/mcp
• dotmira.ru https://dotmira.ru/mcp

每个网站都有自己的地址。登录后连接的助手只能访问你授权的那个网站。

工具：助手可以做什么

• search_effects — 按词语、分类和技术搜索目录；返回标题、作者和链接，不包含代码。
• get_effect — 单个元素的代码：文件、依赖项、许可证、作者和来源，以及从注册表安装它的命令。
• list_categories — 目录分类树，以及每个分类中的元素数量。
• get_preview — 预览图片链接，以及带有实时预览的元素页面链接。

这些工具只读取目录内容，不会更改你的账户信息。

你可以这样提问

• “在 Dotmira 中为 React 找一个发光按钮，并将它添加到我的项目中。”
• “展示 Dotmira 中五种适用于 Tailwind 的动画背景，并附上预览链接。”
• “Dotmira 目录中有哪些分类？”

支持登录的助手：Claude、ChatGPT

在助手的连接器设置中，添加服务地址 https://dotmira.com/mcp，登录 Dotmira 并点击“允许”（OAuth 2.1）。例如，claude.ai 和 ChatGPT 就是通过这种方式连接的。具体设置位置取决于所用助手及其账户。

助手只能访问目录，不会看到你的姓名、电子邮件、电话号码或付款信息。你可以随时在账户中（已连接的应用）撤销访问权限，也可以在助手中移除连接器。

你所在地区能否使用某个助手，由其开发方决定：Anthropic 和 OpenAI 会公布 Claude 和 ChatGPT 可用的国家和地区列表，并非所有国家和地区都在其中。Dotmira 的 MCP 服务和注册表不受你所在国家或地区的影响。

代码编辑器和终端 Agent：个人令牌

Cursor、VS Code、Claude Code，以及其他可连接远程服务并发送标头的 MCP 客户端，都可以使用个人令牌。在你的账户「MCP & registry」部分创建令牌，并在标头中发送 Authorization: Bearer dtm_…。

设置	值
地址（URL）	https://dotmira.com/mcp
传输方式	Streamable HTTP（客户端设置中的“HTTP”或“streamable-http”）
标头	Authorization: Bearer <your token>

Cursor — 文件 .cursor/mcp.json：

{
  "mcpServers": {
    "dotmira": {
      "url": "https://dotmira.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DOTMIRA_TOKEN}"
      }
    }
  }
}

VS Code — 文件 .vscode/mcp.json（VS Code 会在首次连接时询问令牌）：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "dotmira-token",
      "description": "Dotmira token (dtm_…)",
      "password": true
    }
  ],
  "servers": {
    "dotmira": {
      "type": "http",
      "url": "https://dotmira.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:dotmira-token}"
      }
    }
  }
}

Claude Code — 在终端中运行：

claude mcp add --transport http dotmira https://dotmira.com/mcp \
  --header "Authorization: Bearer $DOTMIRA_TOKEN"

检查连接

向服务直接发送请求，以检查令牌和连接：

curl -s https://dotmira.com/mcp \
  -H "Authorization: Bearer $DOTMIRA_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_effects","arguments":{"query":"glow button","limit":3}}}'

服务会以事件流的形式响应：data: 行包含带有找到的元素的 MCP（JSON-RPC）消息，不包含代码。

组件注册表（shadcn）

@dotmira 注册表可与 shadcn CLI 配合使用：npx shadcn@latest add 会将元素文件直接放入你的项目中。它使用同一个个人令牌。

对于程序，注册表是一个 HTTP 地址：携带令牌请求 GET https://dotmira.com/r/<id>.json，即可获得 shadcn 注册表格式（JSON）的元素。

响应代码：

• 401 — 没有令牌，或令牌错误
• 403 — 此账户无权访问代码
• 404 — 不存在此元素
• 429 — 请求过多，请稍后重试

1. 创建个人令牌：账户 → MCP & registry →「Create token」。 立即复制令牌：它只会显示一次。Dotmira 只保留其指纹。

2. 将注册表添加到项目中的 components.json：

   {
     "registries": {
       "@dotmira": {
         "url": "https://dotmira.com/r/{name}.json",
         "headers": {
           "Authorization": "Bearer ${DOTMIRA_TOKEN}"
         }
       }
     }
   }
   

3. 将令牌放入 .env.local（不要将此文件提交到 git），然后安装一个元素：

   # .env.local
   DOTMIRA_TOKEN=dtm_…
   
   npx shadcn@latest add @dotmira/glow-button
   

• 元素 ID 位于其页面地址中（…/e/<id>），或位于 search_effects 的响应中。
• React 元素会连同其文件和 npm 依赖一起安装；HTML/CSS 元素则作为文件安装到 components/dotmira/<id>/。
• 每个文件都带有注释，注明作者、来源、许可证和你的个人标记。
• shadcn MCP 服务（npx shadcn@latest mcp）也支持此注册表：你可以让助手添加 @dotmira/glow-button。

面向 AI Agent 和自动化

代表用户行事的 AI Agent 只能通过 MCP 服务或注册表获取代码，并且必须使用该用户的登录信息或令牌。根据《使用条款》第 5.1 条，禁止自动抓取网站、爬取页面或以其他方式收集代码。也禁止使用目录内容训练 AI 模型（第 5.1 和 5.3 条），包括通过 MCP 服务和注册表获取的内容。搜索引擎以及 AI 搜索和问答服务可以展示并引用公开页面，但必须附上指向网站的链接（第 4.3 条）。

规则

• 只能将 MCP 服务和注册表连接到不会使用你的数据进行训练的助手，或者在助手设置中关闭此类数据使用——这是许可条款（第 5.2 条）的条件。
• 令牌只显示一次：Dotmira 只保留其指纹。撤销令牌后，它会立即失效。
• 访问权限仅限个人使用。不要向任何人提供你的令牌或账户访问权限，包括同事和客户。
• 不要从代码中移除作者、来源、许可证或你的个人标记，也不要将目录代码作为一套组件发布。

完整条款：许可条款和使用条款。

问题与解答

Dotmira 有 API 吗？

有。它提供远程 MCP 服务（https://dotmira.com/mcp）和兼容 shadcn 的组件注册表（https://dotmira.com/r/{name}.json）。两者都基于开放协议运行。它没有 REST 或 GraphQL API，也没有 SDK 或 OpenAPI 描述。

Dotmira 有 MCP 服务吗？

有：远程 MCP 服务位于 https://dotmira.com/mcp，使用 Streamable HTTP 传输，可通过 OAuth 2.1 或个人令牌登录。它提供四个只读工具：search_effects、get_effect、list_categories 和 get_preview。

它支持哪些 AI 助手和代码编辑器？

支持任何可通过 Streamable HTTP 连接远程服务的 MCP 客户端。本页提供 claude.ai、ChatGPT、Cursor、VS Code 和 Claude Code 的使用说明。

它在哪些国家/地区可用？

助手本身是否在你所在的地区可用，由其开发方决定：Anthropic 和 OpenAI 会公布 Claude 和 ChatGPT 可用的国家/地区列表，并非所有国家/地区都在其中。Dotmira 的 MCP 服务和注册表不受你所在国家/地区的影响。

有 REST API、SDK 或 OpenAPI 描述吗？

没有。程序通过 MCP 服务和注册表使用 Dotmira。注册表通过普通 HTTP 请求返回 JSON；MCP 服务通过 HTTP 接收 JSON-RPC 请求。

不使用 AI 助手，也能从自己的程序调用 API 吗？

可以——使用个人令牌即可。禁止提取整个目录或其中很大一部分内容（许可条款第 5.1 条）。

助手会了解我的哪些账户信息？

除了目录内容，什么也看不到。它看不到你的姓名、电子邮件、电话或付款信息。你可以随时在账户中的“已连接的应用”里撤销访问权限。

有命令行工具吗？

Dotmira 没有自己的 CLI：使用 shadcn CLI 安装元素 — npx shadcn@latest add @dotmira/。

AI Agent 能自行浏览网站并复制代码吗？

不能。代码只能通过网站、MCP 服务和注册表获取。根据《使用条款》第 5.1 条，禁止自动抓取网站和收集代码。

代码可以用于训练 AI 模型吗？

不可以。《使用条款》（第 5.1 条和第 5.3 条）及《许可条款》（第 5.1 条和第 5.2 条）均禁止此行为。请只连接不会使用你的数据进行训练的助手。

MCP 服务和注册表有什么区别？

MCP 服务可以让助手在对话中搜索目录并获取代码。注册表则可以通过一条命令按元素 ID 安装元素。两者使用同一个个人令牌。

在哪里可以找到元素 ID？

在元素页面的地址中（…/e/），或在 search_effects 的回答中。

更新日期：2026 年 11 月 12 日